+++ /dev/null
-2005-08-11 Michael Smith <xmldoc@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated for 1.69.1 release.
-
- * VERSION: Version 1.69.1 released.
-
-2005-07-19 Michael Smith <xmldoc@users.sourceforge.net>
-
- * Makefile: New file.
-
-2005-07-18 Michael Smith <xmldoc@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Final changes for 1.69.0 release.
-
- * VERSION: Version 1.69.0 released.
-
-2005-07-14 Michael Smith <xmldoc@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Checkpointing. Still need to add FO section.
-
-2005-06-30 Michael Smith <xmldoc@users.sourceforge.net>
-
- * 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 <xmldoc@users.sourceforge.net>
-
- * .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 <xmldoc@users.sourceforge.net>
-
- * .cvsignore: Ignore slides and website subdirs
-
- * Makefile: Always make NEWS and install.sh
-
-2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
-
- * 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 <kosek@users.sourceforge.net>
-
- * Makefile: branches: 1.23.2;
- Added lib directory to the list of directories for which separate Makefile is called
-
-2005-05-26 Michael Smith <xmldoc@users.sourceforge.net>
-
- * INSTALL: Replaced leftover instances of "Website"
-
- * README: minor formatting change
-
-2005-05-13 Michael Smith <xmldoc@users.sourceforge.net>
-
- * MANIFEST.build: no longer needed
-
- * Makefile: Minor changes to packaging/release-related stuff
-
-2005-05-12 Michael Smith <xmldoc@users.sourceforge.net>
-
- * MANIFEST.build: removed common/Makefile
-
- * Makefile: fixed realclean target (build branch)
-
-2005-05-09 Michael Smith <xmldoc@users.sourceforge.net>
-
- * Makefile: changed to match latest releasetools/Targets.mk updates
-
-2005-04-22 Michael Smith <xmldoc@users.sourceforge.net>
-
- * .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 <xmldoc@users.sourceforge.net>
-
- * .cvsignore: don't ignore catalog.xml (now under version control)
-
- * .urilist: corrected path
-
- * catalog.xml: New file.
-
-2005-04-20 Michael Smith <xmldoc@users.sourceforge.net>
-
- * .cvsignore, AUTHORS, COPYING, INSTALL, LICENSE, README:
- normalize release meta-info/readme files
-
- * .urilist: New file.
-
-2005-04-15 Michael Smith <xmldoc@users.sourceforge.net>
-
- * Makefile: added EXECUTABLES variable, and added scripts to its value
-
-2005-04-11 Michael Smith <xmldoc@users.sourceforge.net>
-
- * Makefile: revert change; put MANIFEST.build exclude in global excludes
-
- * Makefile: don't package\1a
-
-2005-04-06 Michael Smith <xmldoc@users.sourceforge.net>
-
- * Makefile: (build branch): updated to rely on new modular makefile structure
-
-2005-03-31 Michael Smith <xmldoc@users.sourceforge.net>
-
- * Makefile: zip target, don't write dummy stamp
-
-2005-03-28 Michael Smith <xmldoc@users.sourceforge.net>
-
- * Makefile: debian package build tweaks
-
-2005-03-27 Michael Smith <xmldoc@users.sourceforge.net>
-
- * LICENSE: branches: 1.1.2;
- file LICENSE was initially added on branch build.
-
- * LICENSE: New file.
-
-2005-03-25 Michael Smith <xmldoc@users.sourceforge.net>
-
- * Makefile: .deb build and upload automation added
-
-2005-03-19 Michael Smith <xmldoc@users.sourceforge.net>
-
- * INSTALL: typo fixed. (Thanks for Mike Castle)
-
-2005-02-24 Michael Smith <xmldoc@users.sourceforge.net>
-
- * 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 <xmldoc@users.sourceforge.net>
-
- * 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 <xmldoc@users.sourceforge.net>
-
- * 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 <xmldoc@users.sourceforge.net>
-
- * 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 <xmldoc@users.sourceforge.net>
-
- * 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 <xmldoc@users.sourceforge.net>
-
- * Makefile: "upload" target added (uploads to SF FTP incoming directory)
-
-2004-12-02 Michael Smith <xmldoc@users.sourceforge.net>
-
- * .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 <xmldoc@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Final cleanup for 1.67.1 release
-
-2004-11-30 Michael Smith <xmldoc@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Update for 1.67.1 release
-
-2004-11-09 Michael Smith <xmldoc@users.sourceforge.net>
-
- * 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 <nwalsh@users.sourceforge.net>
-
- * VERSION: Capitalization tweaks necessary for the latest freshmeat script
-
-2004-09-20 Michael Smith <xmldoc@users.sourceforge.net>
-
- * VERSION: Version 1.66.1 released.
-
-2004-09-19 Robert Stayton <bobstayton@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated for 1.66.1.
-
- * VERSION: Move to 1.66.1.
-
-2004-09-11 Robert Stayton <bobstayton@users.sourceforge.net>
-
- * 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 <bobstayton@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated for release 1.66.
-
-2004-03-09 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.65.1 released
-
-2004-02-27 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated
-
- * VERSION: Version 1.65.0 released.
-
- * VERSION: No really, version 1.65.0 released.
-
-2004-02-24 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * .cvsignore: Don't ignore debian anymore, it's gone
-
-2004-01-08 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * Makefile: branches: 1.21.2;
- Tweaks for freshmeat-submit
-
- * VERSION: Tweaks for freshmeat-submit
-
-2003-12-31 Jirka Kosek <kosek@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Info about new indexing method
-
-2003-12-19 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * 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 <nwalsh@users.sourceforge.net>
-
- * Makefile, VERSION: Prepare to support freshmeat-submit for next release
-
-2003-12-15 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.64.0 released.
-
- * VERSION: Version 1.63.0 released.
-
-2003-09-29 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.62.4 released.
-
-2003-09-28 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.62.2 released.
-
- * VERSION: Version 1.62.3 released.
-
-2003-09-27 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.62.1 released.
-
-2003-08-31 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.62.0 released.
-
-2003-06-22 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.61.3 released.
-
-2003-05-22 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.61.2 released.
-
-2003-05-19 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Post 1.61.1 updates
-
-2003-05-18 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.61.1 released.
-
- * VERSION: Version 1.60.1 released.
-
-2003-05-08 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated
-
- * VERSION: Post 1.61.0 hacking
-
- * VERSION: Version 1.61.0 released.
-
-2003-01-24 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated
-
- * VERSION: Version 1.60.1 released.
-
-2003-01-23 Adam Di Carlo <adicarlo@users.sourceforge.net>
-
- * Makefile: make use of stuff set in Makefile.incl
-
-2003-01-21 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * Makefile: Test RELEASE-NOTES.xml for validity before formatting it
-
- * VERSION: Version 1.60.0 released.
-
-2003-01-20 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Explain changes to titlepage template code
-
-2003-01-17 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated for 1.59.2 release
-
- * VERSION: Version 1.59.2 released.
-
-2003-01-12 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated release notes for 1.59.1
-
- * VERSION: Version 1.59.1 released.
-
-2003-01-01 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.59.0 released.
-
-2002-11-29 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * Makefile: Exclude the debian directory from the distribution archive
-
- * VERSION: Version 1.58.1 released.
-
-2002-11-17 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * .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 <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.57.0 released.
-
-2002-10-09 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * 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 <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Fixed pubdate
-
- * RELEASE-NOTES.xml: Updated for 1.56.0 release
-
-2002-09-19 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * Makefile: Use the new doc-link-docbook stylesheet for the Release Notes
-
-2002-09-17 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated for 1.55.0
-
- * VERSION: Version 1.55.0 released.
-
-2002-09-03 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * 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 <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Updated for 1.53.0 release
-
- * VERSION: Version 1.53.0 released.
-
-2002-07-10 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.52.2 released.
-
-2002-07-08 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * Makefile: Exclude .#* from zip as well
-
- * VERSION: Keep CVS and real releases distinct
-
- * VERSION: Version 1.52.1 released.
-
-2002-07-07 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * 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 <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.51.1 released.
-
-2002-06-02 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * RELEASE-NOTES.xml: Added release notes for 1.51.0
-
- * VERSION: Version 1.51.0 released.
-
-2002-05-16 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.50.1-EXP2 released.
-
- * VERSION: Oops again.
-
- * VERSION: Oops.
-
-2002-03-25 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * Makefile: Updated xhtml generation
-
- * VERSION: Version 1.50.1-EXP released.
-
-2002-03-21 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * 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 <nwalsh@users.sourceforge.net>
-
- * .cvsignore, Makefile: Added RELEASE-NOTES.html
-
- * RELEASE-NOTES.xml: New file.
-
-2002-03-14 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Keep CVS versions distinct from real releases
-
-2002-03-01 Jirka Kosek <kosek@users.sourceforge.net>
-
- * Makefile: First portion of new profiling code. New stylesheet parameters will come later.
-
-2002-02-21 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * Makefile: Make sure xhtml directory gets built properly
-
-2002-02-20 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.49 released.
-
-2002-01-06 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * Makefile: Clean docsrc
-
- * Makefile: Remove .*~ from the ZIP file
-
- * VERSION: Version 1.48 released.
-
-2001-11-28 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * README: Updated Use section
-
- * VERSION: Keep CVS versions distinct from real releases
-
- * VERSION: Version 1.47 released.
-
-2001-10-13 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.46 released.
-
-2001-09-29 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.45 released.
-
- * VERSION: Keep CVS versions distinct from real releases
-
-2001-08-14 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.44 released.
-
-2001-08-13 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Keep CVS versions distinct from real releases
-
- * VERSION: Version 1.43 released.
-
-2001-08-06 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Keep CVS versions distinct from real releases
-
- * VERSION: Version 1.42 released.
-
-2001-08-04 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Make VERSION a parameter so that it isn't an error some stylesheets override it
-
-2001-07-09 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.41 released.
-
-2001-06-14 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.40 released.
-
-2001-05-24 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.39 released.
-
-2001-05-21 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.38 released.
-
-2001-04-20 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.37 released.
-
-2001-04-15 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * Makefile, README: Make distribution hacks
-
-2001-04-04 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * VERSION: Version 1.36 released.
-
-2001-04-03 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * .cvsignore, Makefile: Misc. cleanup in preparation for making a distrib
-
-2001-04-02 Norman Walsh <nwalsh@users.sourceforge.net>
-
- * BUGS, Makefile, README.CVS, TODO, VERSION: Initial checkin
-
- * Makefile: Make common files
-
+++ /dev/null
-$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.
+++ /dev/null
-Changes since version 1.69.0 (2005-07-18)
-
-Changes to xsl/*
-
- | 2005-08-11 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * RELEASE-NOTES.xml: Updated for 1.69.1 release.
- |
- | * VERSION: Version 1.69.1 released.
- |
- | 2005-07-19 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: New file.
- |
-
-Changes to xsl/fo/*
-
- | 2005-08-09 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <kosek@users.sourceforge.net>
- |
- | * autoidx.xsl: Fixed bug #1244478. Indexterms in informal
- | objects are now getting correct page reference.
- |
- | 2005-07-27 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * pagesetup.xsl: Fixed starting page number for first part
- | element in single-sided output.
- |
-
-Changes to xsl/html/*
-
- | 2005-08-11 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * lists.xsl: Fixed check for first following siblings in
- | lists.
- |
- | 2005-08-09 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <balls@users.sourceforge.net>
- |
- | * pages.template.xml: New file.
- |
- | 2005-08-05 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * part.autolabel.xml: Changed default part numbering format
- | back to 'I'.
- |
- | 2005-07-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * appendix.autolabel.xml: New file.
- |
- | 2005-07-20 Norman Walsh <nwalsh@users.sourceforge.net>
- |
- | * appendix.autolabel.xml: Make appendixes use upperalpha
- | numeration
- |
-
-Changes to xsl/wordml/*
-
- | 2005-08-06 <balls@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * RELEASE-NOTES.xml: Final changes for 1.69.0 release.
- |
- | * VERSION: Version 1.69.0 released.
- |
- | 2005-07-14 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * RELEASE-NOTES.xml: Checkpointing. Still need to add FO
- | section.
- |
- | 2005-06-30 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * .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 <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: Ignore slides and website subdirs
- |
- | * Makefile: Always make NEWS and install.sh
- |
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <kosek@users.sourceforge.net>
- |
- | * Makefile: Added lib directory to the list of directories for
- | which separate Makefile is called
- |
- | 2005-05-26 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * INSTALL: Replaced leftover instances of "Website"
- |
- | * README: minor formatting change
- |
- | 2005-05-13 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * MANIFEST.build: no longer needed
- |
- | * Makefile: Minor changes to packaging/release-related stuff
- |
- | 2005-05-12 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * MANIFEST.build: removed common/Makefile
- |
- | * Makefile: fixed realclean target (build branch)
- |
- | 2005-05-09 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: changed to match latest releasetools/Targets.mk
- | updates
- |
- | 2005-04-22 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .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 <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: don't ignore catalog.xml (now under version
- | control)
- |
- | * .urilist: corrected path
- |
- | * catalog.xml: New file.
- |
- | 2005-04-20 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore, AUTHORS, COPYING, INSTALL, LICENSE, README:
- | normalize release meta-info/readme files
- |
- | * .urilist: New file.
- |
- | 2005-04-15 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: added EXECUTABLES variable, and added scripts to
- | its value
- |
- | 2005-04-11 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: revert change; put MANIFEST.build exclude in
- | global excludes
- |
- | * Makefile: don't package\1a
- |
- | 2005-04-06 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: (build branch): updated to rely on new modular
- | makefile structure
- |
- | 2005-03-31 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: zip target, don't write dummy stamp
- |
- | 2005-03-28 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: debian package build tweaks
- |
- | 2005-03-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * LICENSE: branches: 1.1.2; file LICENSE was initially added
- | on branch build.
- |
- | * LICENSE: New file.
- |
- | 2005-03-25 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: .deb build and upload automation added
- |
- | 2005-03-19 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * INSTALL: typo fixed. (Thanks for Mike Castle)
- |
- | 2005-02-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * refentry.xsl: Add "date" namespace.
- |
- | 2005-07-05 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * common.xsl: Added evaluate.info.profile template.
- |
- | * refentry.xsl: Update header comment.
- |
- | 2005-07-04 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * refentry.xsl: New file.
- |
- | * refentry.xsl: Changed title.
- |
- | 2005-06-30 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * labels.xsl: Gave procedure its own label.markup template
- | because it should not count procedures without title.
- |
- | 2005-06-28 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * olink.xsl: Don't add docname to olink when pointing to root
- | element.
- |
- | 2005-06-06 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .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 <kosek@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <?dbchoice
- | choice="foo"?> as a child a of the list. For example:
- | <para>This release adds localiation support for the
- | following Indic languages: <simplelist type="inline">
- | <?dbchoice choice="and" ?> <member>Hindi</member>
- | <member>Punjabi</member> <member>Tamil</member>
- | <member>Oriya</member> <member>Gujarati</member>
- | </simplelist>. </para> 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": <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:
- | <para>Choose from ONE and ONLY ONE of the following:
- | <simplelist type="inline"> <?dbchoice choice="ou" ?>
- | <member>A</member> <member>B</member> <member>C</member>.
- | </simplelist> </para> That is, use "ou" instead of "or".
- |
- | 2005-05-23 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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: <?dbtimestamp
- | format="d de B de Y"?> 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:
- | <token>d</token> <token>de</token> <token>B</token> ...
- | 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: <space> <tab> <CR> <LF>
- | , . / - ( ) [ ] ::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 <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore, Makefile, l10n.xml: Added Kannada localization
- | (from Siddharudh P T)
- |
- | * l10n.xml: Fixed typo.
- |
- | 2005-05-16 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .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 <xmldoc@users.sourceforge.net>
- |
- | * .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 <xmldoc@users.sourceforge.net>
- |
- | * .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 <xmldoc@users.sourceforge.net>
- |
- | * .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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * olink.xsl: Fix bug in use.local.olink.style.
- |
- | 2005-04-08 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * table.xsl: Applied patches submitted for bug # 1175423.
- |
- | 2005-04-04 Norman Walsh <nwalsh@users.sourceforge.net>
- |
- | * common.xsl: Support xml:id in object.id
- |
- | 2005-03-29 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * targetdatabase.dtd: Added @dir to document, to support
- | Website.
- |
- | 2005-02-21 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <nwalsh@users.sourceforge.net>
- |
- | * website-common.xsl: Explicitly cast summary to a string
- |
- | * website-common.xsl: Support @href on tocentry
- |
- | 2005-04-08 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * toc-tabular.xsl: Fixed logic for @tocskip attribute.
- |
- | 2005-03-29 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: ignore ChangeLog so that I can do "cvstrim"
- | without it getting deleted
- |
- | 2005-04-26 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: switch to DIRS var / base target setup
- |
-
-Changes to xsl/doc/*
-
- | 2005-07-05 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: Added refentry metadata-gathering documentation.
- |
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * Makefile: Revert to Makefile from MAIN
- |
- | 2005-02-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * clrefentry.xsl, tdg-link.xsl: (internal) Added support for
- | TDG hyperlinking with <tag> (instead of just <sgmltag>. Also
- | added support for ignoring <tag>s and <sgmltag>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 <xmldoc@users.sourceforge.net>
- |
- | * Makefile, reference.xml: Added refentry metadata-gathering
- | documentation.
- |
- | 2005-06-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * reference.xml: Made doc source compliant with expectations
- | of doc build.
- |
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * Makefile: make docsrc build depend on params/*.xml files
- |
- | 2005-04-22 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: re-make docsrc if any params files change
- |
- | 2005-03-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * make-xsl-params.pl: xsl-manages-param name corrected
- |
- | 2005-03-07 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * templates.xml: Removed the xsl:import from the example since
- | it doesn't work that way.
- |
- | 2005-02-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * eclipse.xsl: Added support for generating olink database.
- |
-
-Changes to xsl/extensions/*
-
- | 2005-05-13 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: ignore build dir
- |
- | * Makefile: switched to ant-based build
- |
- | * Makefile: revert to MAIN
- |
-
-Changes to xsl/fo/*
-
- | 2005-07-09 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * graphics.xsl: Applied patch #850001 to add content-type
- | property to external-graphic element based on imagedata
- | format attribute.
- |
- | 2005-06-28 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * xep.xsl: Added support for generating <rx:meta-field
- | creator="foo"/> field for XEP. Also, added support for
- | picking up and using contents of <corpauthor> for XEP
- | <rx:meta-field author="foo"/> field.
- |
- | 2005-06-28 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * param.xweb: Doc tweak to match user/developer distinction.
- |
- | 2005-06-27 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * 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 <kosek@users.sourceforge.net>
- |
- | * param.ent, param.xweb: Added references to newly added
- | parameter l10n.gentext.use.xref.language
- |
- | 2005-05-25 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <?dbchoice
- | choice="foo"?> as a child a of the list. For example:
- | <para>This release adds localiation support for the
- | following Indic languages: <simplelist type="inline">
- | <?dbchoice choice="and" ?> <member>Hindi</member>
- | <member>Punjabi</member> <member>Tamil</member>
- | <member>Oriya</member> <member>Gujarati</member>
- | </simplelist>. </para> 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": <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:
- | <para>Choose from ONE and ONLY ONE of the following:
- | <simplelist type="inline"> <?dbchoice choice="ou" ?>
- | <member>A</member> <member>B</member> <member>C</member>.
- | </simplelist> </para> That is, use "ou" instead of "or".
- |
- | 2005-05-16 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * formal.xsl, graphics.xsl, lists.xsl: fixed bug 1201333
- | mediaobjectco images not aligned.
- |
- | 2005-05-13 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: revert to MAIN
- |
- | 2005-05-13 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * xref.xsl: Add basic support for biblioref cross referencing
- | element.
- |
- | 2005-05-06 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * graphics.xsl: Added support for @align on caption in
- | mediaobject.
- |
- | 2005-05-05 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * graphics.xsl: Fixed scalefit to work when
- | contentdepth="100%".
- |
- | 2005-04-29 Norman Walsh <nwalsh@users.sourceforge.net>
- |
- | * docbook.xsl: 'Support' DocBook V5 namespace
- |
- | 2005-04-24 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * autoidx.xsl: Partial fix for bug #1180510
- |
- | 2005-04-22 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * inline.xsl: Fix menuchoice.menu.separator for FOP.
- |
- | 2005-04-20 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * fop.xsl: Added fox:destination extension inside fox:outline
- | to support linking to internal destinations.
- |
- | 2005-04-16 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * division.xsl: Don't start a part toc page sequence unless it
- | has entries.
- |
- | 2005-04-10 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * refentry.xsl: Fixed bug 1180078 where $refentry.pagebreak
- | did not work when refentries were in a reference.
- |
- | 2005-04-08 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * 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 <nwalsh@users.sourceforge.net>
- |
- | * footnote.xsl: Fixed typo in XPath expression
- |
- | * inline.xsl: Support termdef
- |
- | * math.xsl: Support mathphrase
- |
- | 2005-04-03 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * refentry.xsl: Fixed bug where id not output if partintro
- | present in reference element.
- |
- | 2005-03-08 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * glossary.xsl: Added support for title in glosslist.
- |
- | 2005-02-28 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * lists.xsl: Added support for itemizedlist symbol 'none'.
- |
- | 2005-02-23 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * admon.xsl: Implemented the new
- | graphical.admonition.properties and
- | nongraphical.admonition.properties attribute sets.
- |
- | 2005-02-22 <dcramer@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * block.xsl: Added @id to formalpara and some other blocks
- | that were missing it.
- |
- | 2005-02-21 <dcramer@users.sourceforge.net>
- |
- | * 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 <kosek@users.sourceforge.net>
- |
- | * formal.xsl: Align attribute from imagedata is not propagated
- | to surrounding figure because it wrongly affected title
- | alignment.
- |
- | 2005-02-16 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <kosek@users.sourceforge.net>
- |
- | * graphics.xsl, param.ent, param.xweb: Added support for
- | img.src.path parameter into FO stylesheet.
- |
- | 2005-02-15 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * xref.xsl: Change the anchor template to output fo:inline
- | instead of fo:wrapper.
- |
-
-Changes to xsl/html/*
-
- | 2005-07-14 Norman Walsh <nwalsh@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * component.xsl: Removed obsolete templates using
- | mode="component.number".
- |
- | 2005-07-10 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * division.xsl, titlepage.templates.xml: Fixed missing "Part
- | n." label for part titles.
- |
- | 2005-06-28 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * table.xsl: Backed out patch for #1211477 because it breaks
- | table processing in Saxon.
- |
- | 2005-06-01 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * chunktoc.xsl: Fixed bug #1202971, chunktoc doesn't handle
- | the chunk.tocs.and.lots=1 parameter.
- |
- | 2005-05-26 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * chunk-common.xsl, manifest.xsl: Fixed bug #851598 links to
- | legalnotice in html are broken.
- |
- | 2005-05-26 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * titlepage.xsl: Fixed bug #851598 links to legalnotice in
- | html are broken.
- |
- | 2005-05-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <?dbchoice
- | choice="foo"?> as a child a of the list. For example:
- | <para>This release adds localiation support for the
- | following Indic languages: <simplelist type="inline">
- | <?dbchoice choice="and" ?> <member>Hindi</member>
- | <member>Punjabi</member> <member>Tamil</member>
- | <member>Oriya</member> <member>Gujarati</member>
- | </simplelist>. </para> 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": <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:
- | <para>Choose from ONE and ONLY ONE of the following:
- | <simplelist type="inline"> <?dbchoice choice="ou" ?>
- | <member>A</member> <member>B</member> <member>C</member>.
- | </simplelist> </para> That is, use "ou" instead of "or".
- |
- | 2005-05-16 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * glossary.xsl: Now glosssee and glossseealso use full gentext
- | template with substitution.
- |
- | 2005-05-10 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * xref.xsl: Added basic support for biblioref cross
- | referencing.
- |
- | 2005-05-06 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * graphics.xsl: Bug fix if caption align.
- |
- | * graphics.xsl: Added support for @align on caption in
- | mediaobject.
- |
- | 2005-04-29 Norman Walsh <nwalsh@users.sourceforge.net>
- |
- | * docbook.xsl: 'Support' DocBook V5 namespace
- |
- | 2005-04-28 Norman Walsh <nwalsh@users.sourceforge.net>
- |
- | * 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 <nwalsh@users.sourceforge.net>
- |
- | * graphics.xsl: Generate client-side image map for
- | imageobjectco with areas using calspair units
- |
- | 2005-04-10 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * chunk-common.xsl: Fix link to ToC when chunk.toc.and.lots is
- | 1.
- |
- | 2005-04-04 Norman Walsh <nwalsh@users.sourceforge.net>
- |
- | * html.xsl: Support xml:id in anchor
- |
- | * inline.xsl: Support termdef
- |
- | * math.xsl: Support mathphrase
- |
- | 2005-03-09 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * component.xsl: Fixed colophon/subtitle per bug #1156450
- |
- | * footnote.xsl: Fixed bug 1156645: footnote para doesn't
- | propagate role.
- |
- | 2005-03-08 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * block.xsl, titlepage.xsl: Fixed bug 1123291: more than one
- | authorinitials in revhistory.
- |
- | 2005-03-02 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * 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 <kosek@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * param.xweb: Moved use.id.as.filename to chunking section.
- |
-
-Changes to xsl/htmlhelp/*
-
- | 2005-06-21 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * htmlhelp-common.xsl: Fixed bug #1223236. Mode attribute was
- | removed from named templates.
- |
- | 2005-05-24 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * htmlhelp-common.xsl: Classical HTML index is suppressed in a
- | cleaner way as suggested by David Cramer
- |
- | 2005-05-13 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: clean target added
- |
- | * Makefile: revert to MAIN
- |
-
-Changes to xsl/javahelp/*
-
- | 2005-05-13 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: clean target added
- |
- | * Makefile: revert to MAIN
- |
-
-Changes to xsl/lib/*
-
- | 2005-07-08 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * lib.xweb: Added prepend-pad function for right-padding
- | strings to a specific length.
- |
- | 2005-06-28 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * lib.xweb: Fixed typo.
- |
- | 2005-06-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * lib.xweb: Finalized read-character-map() and
- | apply-character-map() functions.
- |
- | 2005-06-18 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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: <?dbtimestamp
- | format="d de B de Y"?> 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:
- | <token>d</token> <token>de</token> <token>B</token> ...
- | 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: <space> <tab> <CR> <LF>
- | , . / - ( ) [ ] ::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 <xmldoc@users.sourceforge.net>
- |
- | * Makefile: Added clean target
- |
- | * Makefile: revert to MAIN
- |
-
-Changes to xsl/manpages/*
-
- | 2005-07-14 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <type>
- | content and any punctuation (parens, semicolons, varargs)
- | also must be bolded.
- |
- | 2005-07-11 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * lists.xsl: Removed redundant template.
- |
- | * param.ent, param.xweb: Added new params for controlling link
- | handling.
- |
- | 2005-07-06 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * param.xweb: Replaced duplicated "charmap" IDs with good
- | ones.
- |
- | 2005-07-05 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <quote> 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 <xmldoc@users.sourceforge.net>
- |
- | * charmap.groff.xsl: Switched to "block" and "class"
- | attributes and back to using real backslashes instead of
- | @esc@ hack.
- |
- | 2005-06-20 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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
- | <type> 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * .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 <a href="#foo">the section called "Bar"</a>. But it
- | works because the manpages stylesheets end up using the text
- | value of the output of the above. Thus, the <a href="#foo">
- | and </a> 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 <?dbchoice
- | choice="foo"?> as a child a of the list. For example:
- | <para>This release adds localiation support for the
- | following Indic languages: <simplelist type="inline">
- | <?dbchoice choice="and" ?> <member>Hindi</member>
- | <member>Punjabi</member> <member>Tamil</member>
- | <member>Oriya</member> <member>Gujarati</member>
- | </simplelist>. </para> 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": <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:
- | <para>Choose from ONE and ONLY ONE of the following:
- | <simplelist type="inline"> <?dbchoice choice="ou" ?>
- | <member>A</member> <member>B</member> <member>C</member>.
- | </simplelist> </para> That is, use "ou" instead of "or".
- |
- | 2005-05-23 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * synop.xsl: Rolled back some over-aggressive line-break
- | cleanup, and removed space-normalizing call in group|arg
- | template because it causes <sbr/> to be handled incorrectly.
- |
- | 2005-05-22 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * .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 <nwalsh@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * man.string.subst.map.xml: Added bullet to set of
- | string-substitution chars.
- |
- | 2005-07-13 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * man.string.subst.map.xml: Added substitutions for \& and \%
- |
- | 2005-07-11 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <bobstayton@users.sourceforge.net>
- |
- | * 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 <kosek@users.sourceforge.net>
- |
- | * component.title.properties.xml: Bibliography in article
- | shouldn't be centered. This stuff really must be refactored
- | better way!
- |
- | 2005-07-08 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * man.charmap.subset.profile.xml, man.string.subst.map.xml:
- | Added "namespace" attributes to non-DocBook <tag>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 <xmldoc@users.sourceforge.net>
- |
- | * 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:
- | <!-- * non-breaking space <substitution oldstring=" "
- | newstring="\ "/> <!-- * copyright sign <substitution
- | oldstring="©" newstring="\(co"/> <!-- * registered
- | sign <substitution oldstring="®" newstring="\(rg"/>
- | <!-- * left double quote <substitution oldstring="“"
- | newstring="\(lq"/> <!-- * right double quote <substitution
- | oldstring="”" newstring="\(rq"/> <!-- * left single
- | quote <substitution oldstring="‘" newstring="\(oq"/>
- | <!-- * right single quote <substitution oldstring="’"
- | newstring="\(cq"/> The reason is that those are all
- | characters that the DocBook XSL stylesheets themselves
- | generate under certain circumstances; so dealing with them
- | in man.string.subst.map ensures they will always be
- | replaced, even if man.charmap.enabled is zero.
- |
- | * man.subheading.divider.enabled.xml,
- | man.subheading.divider.xml: Added
- | man.subheading.divider.enabled flag and tweaked doc for
- | man.subheading.divider
- |
- | * man.th.extra1.suppress.xml, man.th.extra2.max.length.xml,
- | man.th.extra2.suppress.xml, man.th.extra3.max.length.xml,
- | man.th.extra3.suppress.xml, man.th.title.max.length.xml:
- | 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)
- |
- | * refentry.date.profile.enabled.xml,
- | refentry.manual.profile.enabled.xml,
- | refentry.source.name.profile.enabled.xml,
- | refentry.source.name.suppress.xml,
- | refentry.version.profile.enabled.xml,
- | refentry.version.suppress.xml: New file.
- |
- | * refentry.date.profile.xml,
- | refentry.manual.fallback.profile.xml,
- | refentry.manual.profile.xml,
- | refentry.source.fallback.profile.xml,
- | refentry.source.name.profile.xml,
- | refentry.source.name.suppress.xml,
- | refentry.version.profile.xml, refentry.version.suppress.xml:
- | 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.
- |
- | 2005-07-04 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * index.div.title.properties.xml, index.entry.properties.xml:
- | Add start-indent="0pt" to counteract any body.start.indent
- | on an index that is in an article.
- |
- | 2005-06-29 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * man.break.after.slash.xml: New file.
- |
- | * man.subheading.divider.xml: New file.
- |
- | * man.th.title.max.length.xml: New file.
- |
- | 2005-06-28 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * man.alignment.xml, man.hyphenate.xml, man.justify.xml:
- | 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.
- |
- | * man.charmap.enabled.xml: New file.
- |
- | * man.charmap.use.subset.xml: Doc tweak.
- |
- | * man.string.subst.map.xml: Replace hyphens with "\-". <sigh/>
- | Although the old-school gnomes who maintain groff apparently
- | don't figure it's necessary to document this anywhere, there
- | is apparently only one reliable way to make a non-breaking
- | hyphen in groff: with "\-". At least that it what testing in
- | my environment seems to indicate. And because groff is not
- | at all smart in the way it breaks things at hyphens (it
- | will, for example, break command arguments across lines if
- | they contain hyphens), we must globally replace all hyphens
- | with "\-". God in heaven, please let me live to see a day
- | when roff and all is (r)offspring have disappeared from the
- | face of the earth.
- |
- | 2005-06-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * man.charmap.use.subset.xml, man.string.subst.map.xml: Doc
- | tweak.
- |
- | * man.string.subst.map.xml: New file.
- |
- | 2005-06-25 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * man.charmap.subset.profile.xml: Reworked default value to
- | make reworked character map.
- |
- | 2005-06-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * generate.legalnotice.link.xml: Added doc.
- |
- | * generate.revhistory.link.xml: New file.
- |
- | 2005-06-23 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * man.alignment.xml, man.charmap.subset.profile.xml,
- | man.charmap.uri.xml, man.charmap.use.subset.xml,
- | man.hyphenate.xml, man.output.encoding.xml,
- | man.output.quietly.xml: New file.
- |
- | * man.charmap.subset.profile.xml: Fixed markup error.
- |
- | * man.charmap.subset.profile.xml: Added links to Zvon
- | character search form.
- |
- | * man.charmap.subset.profile.xml, man.output.encoding.xml: Doc
- | tweaks
- |
- | * man.output.encoding.xml: Changed default for
- | man.output.encoding to UTF-8. Because character-map
- | processing depends on it. Also added note saying that
- | changing the value to another encoding my break
- | character-map processing, so set man.charmap.enabled to 0 in
- | that case.
- |
- | 2005-06-20 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * component.title.properties.xml: Slides title should also be
- | centered to maintain compatibility with previous versions.
- |
- | 2005-06-14 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * body.start.indent.xml: Clarified the use of this parameter
- | with FOP.
- |
- | 2005-06-01 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * refentry.title.properties.xml: Align refnamediv title
- | correctly when refentry.generate.title is non-zero (closes
- | #1212641). ::Problem: When refentry.generate.title is
- | non-zero, the title output for Refnamediv is not aligned
- | flush left. ::Cause: No code for setting start-indent="" was
- | included in refentry.title.properties. It should be in order
- | to make the Refnamediv title output be flush left, as are
- | titles for all other sectioning children of Refentry ::Fix:
- | Added code for setting start-indent="" in
- | refentry.title.properties.
- |
- | 2005-05-28 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * component.title.properties.xml: Previous change (adding
- | text-align="left") caused article titles to be displayed
- | left aligned instead centered. This was backward
- | incompatible change in presentation. Now attribute set is
- | conditional and outputs text-align="center" for titles of
- | standalone articles. Probably in the future more general fix
- | should be done -- either creating separate
- | article.title.properties, or refactoring FO properties
- | settings between titlepage templates and attribute sets.
- |
- | 2005-05-26 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * l10n.lang.value.rfc.compliant.xml: New file.
- |
- | * variablelist.as.table.xml: Fixed typo.
- |
- | 2005-04-26 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * component.title.properties.xml,
- | section.title.properties.xml: Set text-align to left for
- | chapter and section titles.
- |
- | 2005-04-22 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * menuchoice.menu.separator.xml: Remove fo namespace since no
- | longer needed.
- |
- | * menuchoice.menu.separator.xml: Removed conditional that
- | broke the build process.
- |
- | 2005-04-16 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * menuchoice.menu.separator.xml: Changed to use true arrow
- | character from Symbol font.
- |
- | 2005-04-15 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * abstract.properties.xml, abstract.title.properties.xml: New
- | file.
- |
- | 2005-04-10 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * refentry.pagebreak.xml: Clarified where this parameter
- | applies.
- |
- | 2005-03-08 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * blockquote.properties.xml, component.title.properties.xml,
- | section.title.properties.xml, title.margin.left.xml: Fixed
- | indent problems introduced with $body.start.indent. FOP
- | reverts back to using $title.margin.left.
- |
- | 2005-03-02 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * graphicsize.use.img.src.path.xml: New file.
- |
- | 2005-02-23 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * default.table.frame.xml: New file.
- |
- | 2005-02-23 Robert Stayton <bobstayton@users.sourceforge.net>
- |
- | * graphical.admonition.properties.xml: Added the properties to
- | the attribute-set.
- |
- | 2005-02-15 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * img.src.path.xml: Added support for img.src.path parameter
- | into FO stylesheet.
- |
-
-Changes to xsl/template/*
-
- | 2005-04-29 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * titlepage.xsl: Fixed bug #1189965. Titlepages with element
- | content only (no text interleaved) are not discarded
- | anymore.
- |
-
-Changes to xsl/wordml/*
-
- | 2005-07-12 <balls@users.sourceforge.net>
- |
- | * docbook.xsl, specifications.xml, template.xml,
- | wordml-final.xsl, wordml.xsl: added subtitles, fixed
- | itemizedlist
- |
-
-Changes to xsl/xhtml/*
-
- | 2005-07-18 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: Ignore annotations.xsl
- |
- | 2005-05-13 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: clean target added
- |
- | * Makefile: revert to MAIN
- |
-
-Changes to xsl/debian/*
-
- | 2005-03-28 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: README.Debian and copyright file, added some steps
- | for prepending disclaimer about this not being the official
- | package
- |
- | * Makefile: EMAIL variable instead of PACKAGEREMAIL
- |
- | 2005-03-25 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: DEBVER, pick up from master Makefile; changelog
- | entry, wording tweaked
- |
- | 2005-03-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: New file.
- |
- | * Makefile: branches: 1.1.2; file Makefile was initially added
- | on branch build.
- |
-
-Changes to xsl/slides/fo/*
-
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: added ChangLog to .cvsignore files, so that I
- | can do a "cvstrim" without them getting deleted
- |
-
-Changes to xsl/slides/html/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * param.xweb: Added clarification that current params are for
- | HTML output only.
- |
- | * param.xweb: And yet more clarifications...
- |
- | * param.xweb: Further clarifications.
- |
- | 2005-05-04 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * frames.xsl: escape single quotation marks in ToC for titles
- | and titleabbrev in foilgroup and foil (closes bug #1194308;
- | thanks to Tomas Hajek for reporting the bug)
- |
- | * frames.xsl, slides-common.xsl: remove/replace generation of
- | <a name="{$id}"> instances; some were removed because they
- | were redundant and were causing invalid duplicate ID values
- | to be generated; others were replaced by moving the ID and
- | value to the parent (closes bug #1069140; thanks to Emma
- | Jane Hogbin for reporting the problem)
- |
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: added ChangLog to .cvsignore files, so that I
- | can do a "cvstrim" without them getting deleted
- |
- | * frames.xsl, slides-common.xsl: add meta generator stamp
- |
- | 2005-04-26 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: added "clean" targets
- |
- | 2005-04-22 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * frames.xsl: "foilgroup" in filenames instead of "foilgrp"
- | (for clarity and because of report that "filegrp" caused
- | some kind of linking problem
- |
- | * slides-common.xsl: Added support for dbhtml dir PI (Tracker
- | #1179044). Thanks to Mauritz Jeanson for the patch. And to
- | M. Sean Gilligan for submitting the original request (on
- | docbook-apps).
- |
-
-Changes to xsl/slides/htmlhelp/*
-
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
-
-Changes to xsl/slides/keynote/*
-
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
- | 2005-04-22 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * ChangeLog: ChangeLog should not be under version control
- |
-
-Changes to xsl/slides/svg/*
-
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
-
-Changes to xsl/slides/xhtml/*
-
- | 2005-05-04 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: ignore html2xhtml.xsl
- |
- | * Makefile, html2xhtml.xsl: remove html2xhtml.xsl from version
- | control and instead make by copying from docbook-xsl
- | html2xhtml.xsl
- |
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: added ChangLog to .cvsignore files, so that I
- | can do a "cvstrim" without them getting deleted
- |
- | * Makefile: add meta generator stamp
- |
- | 2005-04-26 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: added "clean" targets
- |
-
-Changes to xsl/slides/graphics/*
-
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
-
-Changes to xsl/slides/browser/*
-
- | 2005-06-21 Jirka Kosek <kosek@users.sourceforge.net>
- |
- | * slides.js: Added support for keyboard navigation in Opera.
- | It was not very hard given fact that Opera tries to be as
- | compatible with IE as possible ;-)
- |
- | 2005-05-09 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * slides.js: ::Problem: PAGE UP, PAGE DOWN, and HOME keyboard
- | shortcuts not longer work as expected ::Cause: Shortcuts
- | were replaced with letter-key shortcuts (N, P, H). ::Fix:
- | Restored PAGE UP, PAGE DOWN, and HOME shortcuts by appending
- | those keys to the list of valid shortcuts. Now, both those
- | and the letter-key shortcuts are available. Also, added
- | RIGHT ARROW, LEFT ARROW, and UP ARROW shortcuts. The
- | complete list of shortcuts is now: * forward = n, N, SPACE,
- | ENTER, RETURN, PAGE UP, RIGHT ARROW * backward = p, P,
- | BACKSPACE, PAGE DOWN, LEFT ARROW * up = u, U, UP ARROW *
- | home = h, H, HOME * toc = t, T (Closes bug #1196429; thanks
- | to Roland Huss for reporting the problem)
- |
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
-
-Changes to xsl/doc/common/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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.
- |
-
-Changes to xsl/doc/fo/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * Makefile: clean target now removes generated *.html param
- | files
- |
- | * Makefile: revert to Makefile from MAIN
- |
- | 2005-02-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile: make clean now does rm -f *.html to clean out all
- | html files; also *.png
- |
- | * Makefile: *.png -- don't remove on clean (file is under
- | version control)
- |
-
-Changes to xsl/doc/html/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * Makefile: create param.html stamp so that it doesn't get
- | remade if nothing changes
- |
- | * Makefile: revert to Makefile from MAIN
- |
-
-Changes to xsl/doc/lib/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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.
- |
-
-Changes to xsl/doc/manpages/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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-02-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
- | * Makefile: New file.
- |
-
-Changes to xsl/doc/pi/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * Makefile: revert to version from MAIN
- |
- | * Makefile: touch pi.html so that nothing gets unnecessarily
- | remade
- |
-
-Changes to xsl/doc/template/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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.
- |
-
-Changes to xsl/doc/tools/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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 <xmldoc@users.sourceforge.net>
- |
- | * Makefile: use Makefile from MAIN instead
- |
- | * Makefile: Changed order of build
- |
-
-Changes to xsl/doc/refentry/*
-
- | 2005-07-05 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore, Makefile: New file.
- |
-
-Changes to xsl/doc/website/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore, Makefile: New file.
- |
-
-Changes to xsl/docsrc/fo/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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.
- |
-
-Changes to xsl/docsrc/html/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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.
- |
-
-Changes to xsl/docsrc/manpages/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * 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-02-24 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
- | * Makefile: New file.
- |
-
-Changes to xsl/docsrc/website/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore, Makefile: New file.
- |
-
-Changes to xsl/docsrc/refentry/*
-
- | 2005-07-05 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore, Makefile: New file.
- |
-
-Changes to xsl/slides/keynote/xsltsl/*
-
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
-
-Changes to xsl/slides/graphics/active/*
-
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
-
-Changes to xsl/slides/graphics/inactive/*
-
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
-
-Changes to xsl/slides/graphics/toc/*
-
- | 2005-04-27 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore: New file.
- |
-
-Changes to xsl/doc/slides/html/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore, Makefile: New file.
- |
-
-Changes to xsl/docsrc/slides/html/*
-
- | 2005-06-17 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * .cvsignore, Makefile: New file.
- |
-
-Changes to xsl/extensions/saxon643/.classes/*
-
- | 2005-05-13 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile.common: revert to MAIN
- |
-
-Changes to xsl/extensions/xalan2/.classes/*
-
- | 2005-05-13 Michael Smith <xmldoc@users.sourceforge.net>
- |
- | * Makefile.common: revert to MAIN
- |
-
+++ /dev/null
-<html><head>
- <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
- <title>DocBook XSL Stylesheet Release Notes</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="d0e1"></a>DocBook XSL Stylesheet Release Notes</h1></div><div><h3 class="corpauthor">DocBook Project Development Team</h3></div><div><p class="releaseinfo">$Id$</p></div><div><p class="pubdate">2005-08-12</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e22">Release 1.69.1</a></span></dt><dt><span class="section"><a href="#d0e40">Release 1.69.0</a></span></dt><dd><dl><dt><span class="section"><a href="#V1690_COMMON">Common</a></span></dt><dt><span class="section"><a href="#V1690_FO">FO</a></span></dt><dt><span class="section"><a href="#V1690_HELP">Help</a></span></dt><dt><span class="section"><a href="#V1690_HTML">HTML</a></span></dt><dt><span class="section"><a href="#V1690_MAN">man</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e1625">Release 1.68.1</a></span></dt><dt><span class="section"><a href="#d0e1634">Release 1.68.0</a></span></dt><dt><span class="section"><a href="#d0e1872">Release 1.67.2</a></span></dt><dt><span class="section"><a href="#d0e1877">Release 1.67.1</a></span></dt><dt><span class="section"><a href="#d0e2044">Release 1.67.0</a></span></dt><dt><span class="section"><a href="#d0e2175">Release 1.66.1</a></span></dt><dt><span class="section"><a href="#d0e2462">Release 1.65.0</a></span></dt><dt><span class="section"><a href="#d0e2498">Release 1.64.1</a></span></dt><dt><span class="section"><a href="#d0e2513">Release 1.61.0</a></span></dt><dt><span class="section"><a href="#d0e2703">Release 1.60.1</a></span></dt><dt><span class="section"><a href="#d0e2880">Release 1.59.2</a></span></dt><dt><span class="section"><a href="#d0e2916">Release 1.59.1</a></span></dt><dt><span class="section"><a href="#d0e2988">Release 1.58.0</a></span></dt><dt><span class="section"><a href="#d0e3036">Release 1.57.0</a></span></dt><dt><span class="section"><a href="#d0e3043">Release 1.56.0</a></span></dt><dt><span class="section"><a href="#d0e3265">Older releases</a></span></dt><dt><span class="section"><a href="#dot0">About dot-zero releases</a></span></dt></dl></div><p>These are the release notes for the DocBook XSL Stylesheets.
- At a minimum, this file attempts to document changes to the public
- APIs, particularly to user-configurable parameters. This file also
- provides a high-level overview of the features added in each
- release.</p><p>Bug fixes are (mostly) not documented here. For a complete
- list of changes, including descriptions of bug fixes, see the <a href="NEWS" target="_top">NEWS</a> file, which is auto-generated from the checkin
- descriptions for changes in the project CVS repository.</p><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e22"></a>Release 1.69.1</h2></div></div></div><p>This release is a minor bug-fix update to the 1.69.0
- release. Along with bug fixes, it includes one
- configuration-parameter change: The default value of the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.support.html"><em class="parameter"><code>annotation.support</code></em></a> parameter is now
- <code class="literal">0</code> (off). The reason for that change is that
- there have been reports that <code class="sgmltag-element">annotation</code> handling is
- causing a significant performance degradation in processing of
- large documents with <span><strong class="command">xsltproc</strong></span>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e40"></a>Release 1.69.0</h2></div></div></div><p>The release includes major feature changes,
- particularly in the <a href="#V1690_MAN" title="man">manpages
- stylesheets</a>, as well as a large number of bug fixes.</p><p>As with all DocBook Project “<span class="quote">dot zero</span>” releases, this is an
- <a href="#dot0" title="About dot-zero releases">experimental release </a>.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_COMMON"></a>Common</h3></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>This release adds localizations for the following
- languages:
- <span class="simplelist">Albanian, Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian, Oriya, Punjabi, Tagalog, Tamil, and Welsh</span>.</p></li><li><p>Added support for specifying number format for auto
- labels for <a href="http://www.docbook.org/tdg/en/html/chapter.html"><code class="sgmltag-element">chapter</code></a>, <a href="http://www.docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a>,
- <a href="http://www.docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a>, and <a href="http://www.docbook.org/tdg/en/html/preface.html"><code class="sgmltag-element">preface</code></a>. Contolled with the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/appendix.autolabel.html"><em class="parameter"><code>appendix.autolabel</code></em></a>,
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chapter.autolabel.html"><em class="parameter"><code>chapter.autolabel</code></em></a>,
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/part.autolabel.html"><em class="parameter"><code>part.autolabel</code></em></a>, and
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/preface.autolabel.html"><em class="parameter"><code>preface.autolabel</code></em></a> parameters.</p></li><li><p>Added basic support for <code class="sgmltag-element">biblioref</code> cross
- referencing.</p></li><li><p>Added support for <code class="sgmltag-attribute">align</code>
- on <a href="http://www.docbook.org/tdg/en/html/caption.html"><code class="sgmltag-element">caption</code></a> in <a href="http://www.docbook.org/tdg/en/html/mediaobject.html"><code class="sgmltag-element">mediaobject</code></a>.</p></li><li><p>Added support for processing documents that use the
- DocBook V5 namespace.</p></li><li><p>Added support for <code class="sgmltag-element">termdef</code> and
- <code class="sgmltag-element">mathphrase</code>.</p></li><li><p>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
- <code class="filename">tabular.xsl</code> file: </p><pre class="literallayout"><code class="uri">http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl</code></pre></li><li><p>A <a href="http://www.docbook.org/tdg/en/html/procedure.html"><code class="sgmltag-element">procedure</code></a> without a <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> is
- now treated as an “<span class="quote">informal</span>” procedure (meaning
- that it is not added to any generated “<span class="quote">list of
- procedures</span>” and has no affect on numbering of
- generated labels for other procedures).</p></li><li><p><code class="sgmltag-element">docname</code> is no longer added to
- <a href="http://www.docbook.org/tdg/en/html/olink.html"><code class="sgmltag-element">olink</code></a> when pointing to a root element.</p></li><li><p>Added support for generation of choice separator in
- inline simplelist. This enables auto-generation of an
- appropriate localized “<span class="quote">choice separator</span>” (for
- example, “<span class="quote">and</span>” or “<span class="quote">or</span>”) before the
- final item in an inline <a href="http://www.docbook.org/tdg/en/html/simplelist.html"><code class="sgmltag-element">simplelist</code></a>.</p><p>To indicate that you want a choice separator
- generated for a particular list, you need to put a processing
- instruction (PI) of the form
- <code class="sgmltag-xmlpi"><?dbchoice choice="foo"?></code> as a
- child of the list. For example:
- </p><pre class="literallayout"> <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></pre><p>
-
- Output (for English):
- </p><div class="blockquote"><blockquote class="blockquote"><p>Choose from ONE and only ONE of the
- following choices: A, B, or C.</p></blockquote></div><p>
- As a temporary workaround for the fact that most of the
- DocBook non-English locale files don't have a localization for
- the word “<span class="quote">or</span>”, you can put in a literal string to
- be used; example for French: <code class="sgmltag-pi"><?dbchoice choice="ou"></code>. That is, use
- “<span class="quote">ou</span>” instead of “<span class="quote">or</span>”.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_FO"></a>FO</h3></div></div></div><div class="itemizedlist"><ul type="disc"><li><p> Added <code class="literal">content-type</code> property to
- <code class="literal">external-graphic</code> element, based on
- <a href="http://www.docbook.org/tdg/en/html/imagedata.html"><code class="sgmltag-element">imagedata</code></a> <code class="sgmltag-attribute">format</code>
- attribute.</p></li><li><p>Added support for generating
- <code class="literal"><rx:meta-field creator="$VERSION"/></code>
- field for XEP output. This makes the DocBook XSL
- stylesheet version information available through the
- <span class="guimenu">Document Properties</span> menu in Acrobat
- Reader and other PDF viewers.</p></li><li><p>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
- <code class="sgmltag-attribute">class</code> attribute on the
- <a href="http://www.docbook.org/tdg/en/html/trademark.html"><code class="sgmltag-element">trademark</code></a> element, the HTML stylesheets would
- default to rendering a superscript <code class="literal">TM
- </code>symbol after the <a href="http://www.docbook.org/tdg/en/html/trademark.html"><code class="sgmltag-element">trademark</code></a> contents,
- but the FO stylesheets would render nothing.</p></li><li><p>Added support for generating XEP bookmarks for
- <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>.</p></li><li><p>Added support for HTML markup <a href="http://www.docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> <code class="sgmltag-attribute">border</code> attribute, applied to each
- table cell.</p></li><li><p>The <code class="function">table.width</code> template can now
- sum column specs if none use <code class="literal">%</code> or
- <code class="literal">*</code>.</p></li><li><p>Added <code class="literal">fox:destination</code> extension
- inside <code class="literal">fox:outline</code> to support linking to
- internal destinations.</p></li><li><p>Added support for customizing
- <code class="literal">abstract</code> with property sets. Controlled
- with the <em class="parameter"><code>abstract.properties</code></em> and
- <em class="parameter"><code>abstract.title.properties</code></em>
- parameters.</p></li><li><p>Add <a href="http://www.docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a>s in <a href="http://www.docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> title to
- table footnote set, and add support for table footnotes to
- HTML table markup.</p></li><li><p>Added support for <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> in
- <a href="http://www.docbook.org/tdg/en/html/glosslist.html"><code class="sgmltag-element">glosslist</code></a>.</p></li><li><p>Added support for <a href="http://www.docbook.org/tdg/en/html/itemizedlist.html"><code class="sgmltag-element">itemizedlist</code></a> symbol
- <code class="literal">none</code>.</p></li><li><p>Implemented the new
- <em class="parameter"><code>graphical.admonition.properties</code></em> and
- <em class="parameter"><code>nongraphical.admonition.properties</code></em>
- attribute sets.</p></li><li><p>Added <code class="sgmltag-attribute">id</code> to
- <a href="http://www.docbook.org/tdg/en/html/formalpara.html"><code class="sgmltag-element">formalpara</code></a> and some other blocks that were
- missing it.</p></li><li><p>Changed the anchor template to output
- <code class="literal">fo:inline</code> instead of
- <code class="literal">fo:wrapper</code>.</p></li><li><p>Added support for <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/toc.max.depth.html"><em class="parameter"><code>toc.max.depth</code></em></a>
- parameter.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_HELP"></a>Help</h3></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Eclipse Help: Added support for generating olink
- database.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_HTML"></a>HTML</h3></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Added a first cut at support in HTML output for
- DocBook 5 style <code class="sgmltag-element">annotation</code>s. Controlled using the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.support.html"><em class="parameter"><code>annotation.support</code></em></a> parameter, and
- implemented using JavaScript and CSS styling. For more
- details, see the documentation for the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.js.html"><em class="parameter"><code>annotation.js</code></em></a>,
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.css.html"><em class="parameter"><code>annotation.css</code></em></a>,
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.graphic.open.html"><em class="parameter"><code>annotation.graphic.open</code></em></a>, and
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/annotation.graphic.close.html"><em class="parameter"><code>annotation.graphic.close</code></em></a>
- parameters.</p></li><li><p>Generate client-side image map for
- <a href="http://www.docbook.org/tdg/en/html/imageobjectco.html"><code class="sgmltag-element">imageobjectco</code></a> with areas using
- <code class="literal">calspair</code> units</p></li><li><p>Added support for <code class="sgmltag-xmlpi"><?img.src.path?></code> PI.</p></li><li><p>Added support for passing
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/img.src.path.html"><em class="parameter"><code>img.src.path</code></em></a> to DocBook Java XSLT
- image extensions when appropriate. Controlled using the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/graphicsize.use.img.src.path.html"><em class="parameter"><code>graphicsize.use.img.src.path</code></em></a>
- parameter.</p></li><li><p>Added support for (not
- valid for DocBook 4) <code class="sgmltag-attribute">xlink:href</code>
- on <a href="http://www.docbook.org/tdg/en/html/area.html"><code class="sgmltag-element">area</code></a> and (not valid for DocBook 4)
- <a href="http://www.docbook.org/tdg/en/html/alt.html"><code class="sgmltag-element">alt</code></a> in <a href="http://www.docbook.org/tdg/en/html/area.html"><code class="sgmltag-element">area</code></a>.</p></li><li><p>Added new parameter
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/default.table.frame.html"><em class="parameter"><code>default.table.frame</code></em></a> to control table
- framing if there is no <code class="sgmltag-attribute">frame</code>
- attribute on a table.</p></li><li><p>Added initial, experimental support for generating
- content for the HTML <code class="literal">title</code> attribute from
- content of the <a href="http://www.docbook.org/tdg/en/html/alt.html"><code class="sgmltag-element">alt</code></a> element. This change adds
- support for the following inline elements only (none of them
- are block elements):
- <span class="simplelist"><a href="http://www.docbook.org/tdg/en/html/abbrev.html"><code class="sgmltag-element">abbrev</code></a>, <a href="http://www.docbook.org/tdg/en/html/accel.html"><code class="sgmltag-element">accel</code></a>, <a href="http://www.docbook.org/tdg/en/html/acronym.html"><code class="sgmltag-element">acronym</code></a>, <a href="http://www.docbook.org/tdg/en/html/action.html"><code class="sgmltag-element">action</code></a>, <a href="http://www.docbook.org/tdg/en/html/application.html"><code class="sgmltag-element">application</code></a>, <a href="http://www.docbook.org/tdg/en/html/authorinitials.html"><code class="sgmltag-element">authorinitials</code></a>, <a href="http://www.docbook.org/tdg/en/html/beginpage.html"><code class="sgmltag-element">beginpage</code></a>, <a href="http://www.docbook.org/tdg/en/html/citation.html"><code class="sgmltag-element">citation</code></a>, <a href="http://www.docbook.org/tdg/en/html/citerefentry.html"><code class="sgmltag-element">citerefentry</code></a>, <a href="http://www.docbook.org/tdg/en/html/citetitle.html"><code class="sgmltag-element">citetitle</code></a>, <a href="http://www.docbook.org/tdg/en/html/city.html"><code class="sgmltag-element">city</code></a>, <a href="http://www.docbook.org/tdg/en/html/classname.html"><code class="sgmltag-element">classname</code></a>, <code class="sgmltag-element">code</code>, <a href="http://www.docbook.org/tdg/en/html/command.html"><code class="sgmltag-element">command</code></a>, <a href="http://www.docbook.org/tdg/en/html/computeroutput.html"><code class="sgmltag-element">computeroutput</code></a>, <a href="http://www.docbook.org/tdg/en/html/constant.html"><code class="sgmltag-element">constant</code></a>, <a href="http://www.docbook.org/tdg/en/html/country.html"><code class="sgmltag-element">country</code></a>, <a href="http://www.docbook.org/tdg/en/html/database.html"><code class="sgmltag-element">database</code></a>, <a href="http://www.docbook.org/tdg/en/html/email.html"><code class="sgmltag-element">email</code></a>, <a href="http://www.docbook.org/tdg/en/html/envar.html"><code class="sgmltag-element">envar</code></a>, <a href="http://www.docbook.org/tdg/en/html/errorcode.html"><code class="sgmltag-element">errorcode</code></a>, <a href="http://www.docbook.org/tdg/en/html/errorname.html"><code class="sgmltag-element">errorname</code></a>, <a href="http://www.docbook.org/tdg/en/html/errortext.html"><code class="sgmltag-element">errortext</code></a>, <a href="http://www.docbook.org/tdg/en/html/errortype.html"><code class="sgmltag-element">errortype</code></a>, <a href="http://www.docbook.org/tdg/en/html/exceptionname.html"><code class="sgmltag-element">exceptionname</code></a>, <a href="http://www.docbook.org/tdg/en/html/fax.html"><code class="sgmltag-element">fax</code></a>, <a href="http://www.docbook.org/tdg/en/html/filename.html"><code class="sgmltag-element">filename</code></a>, <a href="http://www.docbook.org/tdg/en/html/firstname.html"><code class="sgmltag-element">firstname</code></a>, <a href="http://www.docbook.org/tdg/en/html/firstterm.html"><code class="sgmltag-element">firstterm</code></a>, <a href="http://www.docbook.org/tdg/en/html/foreignphrase.html"><code class="sgmltag-element">foreignphrase</code></a>, <a href="http://www.docbook.org/tdg/en/html/function.html"><code class="sgmltag-element">function</code></a>, <a href="http://www.docbook.org/tdg/en/html/glossterm.html"><code class="sgmltag-element">glossterm</code></a>, <a href="http://www.docbook.org/tdg/en/html/guibutton.html"><code class="sgmltag-element">guibutton</code></a>, <a href="http://www.docbook.org/tdg/en/html/guiicon.html"><code class="sgmltag-element">guiicon</code></a>, <a href="http://www.docbook.org/tdg/en/html/guilabel.html"><code class="sgmltag-element">guilabel</code></a>, <a href="http://www.docbook.org/tdg/en/html/guimenu.html"><code class="sgmltag-element">guimenu</code></a>, <a href="http://www.docbook.org/tdg/en/html/guimenuitem.html"><code class="sgmltag-element">guimenuitem</code></a>, <a href="http://www.docbook.org/tdg/en/html/guisubmenu.html"><code class="sgmltag-element">guisubmenu</code></a>, <a href="http://www.docbook.org/tdg/en/html/hardware.html"><code class="sgmltag-element">hardware</code></a>, <a href="http://www.docbook.org/tdg/en/html/honorific.html"><code class="sgmltag-element">honorific</code></a>, <a href="http://www.docbook.org/tdg/en/html/interface.html"><code class="sgmltag-element">interface</code></a>, <a href="http://www.docbook.org/tdg/en/html/interfacename.html"><code class="sgmltag-element">interfacename</code></a>, <a href="http://www.docbook.org/tdg/en/html/keycap.html"><code class="sgmltag-element">keycap</code></a>, <a href="http://www.docbook.org/tdg/en/html/keycode.html"><code class="sgmltag-element">keycode</code></a>, <a href="http://www.docbook.org/tdg/en/html/keysym.html"><code class="sgmltag-element">keysym</code></a>, <a href="http://www.docbook.org/tdg/en/html/lineage.html"><code class="sgmltag-element">lineage</code></a>, <a href="http://www.docbook.org/tdg/en/html/lineannotation.html"><code class="sgmltag-element">lineannotation</code></a>, <a href="http://www.docbook.org/tdg/en/html/literal.html"><code class="sgmltag-element">literal</code></a>, <a href="http://www.docbook.org/tdg/en/html/markup.html"><code class="sgmltag-element">markup</code></a>, <a href="http://www.docbook.org/tdg/en/html/medialabel.html"><code class="sgmltag-element">medialabel</code></a>, <a href="http://www.docbook.org/tdg/en/html/methodname.html"><code class="sgmltag-element">methodname</code></a>, <a href="http://www.docbook.org/tdg/en/html/mousebutton.html"><code class="sgmltag-element">mousebutton</code></a>, <a href="http://www.docbook.org/tdg/en/html/option.html"><code class="sgmltag-element">option</code></a>, <a href="http://www.docbook.org/tdg/en/html/optional.html"><code class="sgmltag-element">optional</code></a>, <a href="http://www.docbook.org/tdg/en/html/otheraddr.html"><code class="sgmltag-element">otheraddr</code></a>, <a href="http://www.docbook.org/tdg/en/html/othername.html"><code class="sgmltag-element">othername</code></a>, <code class="sgmltag-element">package</code>, <a href="http://www.docbook.org/tdg/en/html/parameter.html"><code class="sgmltag-element">parameter</code></a>, <a href="http://www.docbook.org/tdg/en/html/personname.html"><code class="sgmltag-element">personname</code></a>, <a href="http://www.docbook.org/tdg/en/html/phone.html"><code class="sgmltag-element">phone</code></a>, <a href="http://www.docbook.org/tdg/en/html/pob.html"><code class="sgmltag-element">pob</code></a>, <a href="http://www.docbook.org/tdg/en/html/postcode.html"><code class="sgmltag-element">postcode</code></a>, <a href="http://www.docbook.org/tdg/en/html/productname.html"><code class="sgmltag-element">productname</code></a>, <a href="http://www.docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a>, <a href="http://www.docbook.org/tdg/en/html/prompt.html"><code class="sgmltag-element">prompt</code></a>, <a href="http://www.docbook.org/tdg/en/html/property.html"><code class="sgmltag-element">property</code></a>, <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a>, <a href="http://www.docbook.org/tdg/en/html/refentrytitle.html"><code class="sgmltag-element">refentrytitle</code></a>, <a href="http://www.docbook.org/tdg/en/html/remark.html"><code class="sgmltag-element">remark</code></a>, <a href="http://www.docbook.org/tdg/en/html/replaceable.html"><code class="sgmltag-element">replaceable</code></a>, <a href="http://www.docbook.org/tdg/en/html/returnvalue.html"><code class="sgmltag-element">returnvalue</code></a>, <a href="http://www.docbook.org/tdg/en/html/sgmltag.html"><code class="sgmltag-element">sgmltag</code></a>, <a href="http://www.docbook.org/tdg/en/html/shortcut.html"><code class="sgmltag-element">shortcut</code></a>, <a href="http://www.docbook.org/tdg/en/html/state.html"><code class="sgmltag-element">state</code></a>, <a href="http://www.docbook.org/tdg/en/html/street.html"><code class="sgmltag-element">street</code></a>, <a href="http://www.docbook.org/tdg/en/html/structfield.html"><code class="sgmltag-element">structfield</code></a>, <a href="http://www.docbook.org/tdg/en/html/structname.html"><code class="sgmltag-element">structname</code></a>, <a href="http://www.docbook.org/tdg/en/html/subscript.html"><code class="sgmltag-element">subscript</code></a>, <a href="http://www.docbook.org/tdg/en/html/superscript.html"><code class="sgmltag-element">superscript</code></a>, <a href="http://www.docbook.org/tdg/en/html/surname.html"><code class="sgmltag-element">surname</code></a>, <a href="http://www.docbook.org/tdg/en/html/symbol.html"><code class="sgmltag-element">symbol</code></a>, <a href="http://www.docbook.org/tdg/en/html/systemitem.html"><code class="sgmltag-element">systemitem</code></a>, <code class="sgmltag-element">tag</code>, <code class="sgmltag-element">termdef</code>, <a href="http://www.docbook.org/tdg/en/html/token.html"><code class="sgmltag-element">token</code></a>, <a href="http://www.docbook.org/tdg/en/html/trademark.html"><code class="sgmltag-element">trademark</code></a>, <a href="http://www.docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a>, <code class="sgmltag-element">uri</code>, <a href="http://www.docbook.org/tdg/en/html/userinput.html"><code class="sgmltag-element">userinput</code></a>, <a href="http://www.docbook.org/tdg/en/html/varname.html"><code class="sgmltag-element">varname</code></a>, and <a href="http://www.docbook.org/tdg/en/html/wordasword.html"><code class="sgmltag-element">wordasword</code></a></span>
- </p></li><li><p>Added support for chunking <a href="http://www.docbook.org/tdg/en/html/revhistory.html"><code class="sgmltag-element">revhistory</code></a> into
- separate file (similar to the support for doing same with
- <a href="http://www.docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a>). Patch from Thomas
- Schraitle. Controlled through <em class="parameter"><code>new
- generate.revhistory.link</code></em> parameter.</p></li><li><p>l10n.xsl: Made language codes RFC compliant. Added a
- new boolean config parameter,
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/l10n.lang.value.rfc.compliant.html"><em class="parameter"><code>l10n.lang.value.rfc.compliant</code></em></a>. 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.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="V1690_MAN"></a>man</h3></div></div></div><p>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.</p><div class="itemizedlist"><ul type="disc"><li><p>New options for globally disabling/enabling
- hyphenation and justification:
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.justify.html"><em class="parameter"><code>man.justify</code></em></a> and
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.hyphenate.html"><em class="parameter"><code>man.hyphenate</code></em></a>.</p><p>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
- “<span class="quote">Hyphenation</span>” node from the groff info page:
- </p><div class="blockquote"><blockquote class="blockquote"><p><span class="emphasis"><em>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.</em></span></p></blockquote></div><p>
- 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.</p></li><li><p> 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
- <a href="http://www.docbook.org/tdg/en/html/classname.html"><code class="sgmltag-element">classname</code></a>, <a href="http://www.docbook.org/tdg/en/html/constant.html"><code class="sgmltag-element">constant</code></a>, <a href="http://www.docbook.org/tdg/en/html/envar.html"><code class="sgmltag-element">envar</code></a>,
- <a href="http://www.docbook.org/tdg/en/html/errorcode.html"><code class="sgmltag-element">errorcode</code></a>, <a href="http://www.docbook.org/tdg/en/html/option.html"><code class="sgmltag-element">option</code></a>,
- <a href="http://www.docbook.org/tdg/en/html/replaceable.html"><code class="sgmltag-element">replaceable</code></a>, <a href="http://www.docbook.org/tdg/en/html/userinput.html"><code class="sgmltag-element">userinput</code></a>,
- <a href="http://www.docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a>, and <a href="http://www.docbook.org/tdg/en/html/varname.html"><code class="sgmltag-element">varname</code></a>, and for
- <code class="sgmltag-element">filenames</code>, and for URLs from <a href="http://www.docbook.org/tdg/en/html/link.html"><code class="sgmltag-element">link</code></a>. It
- can be (re)enabled using the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.hyphenate.computer.inlines.html"><em class="parameter"><code>man.hyphenate.computer.inlines</code></em></a>,
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.hyphenate.filenames.html"><em class="parameter"><code>man.hyphenate.filenames</code></em></a>, and
- <em class="parameter"><code>man.hyphenate.urls parameters</code></em>.</p></li><li><p>Implemented a new system for replacing Unicode
- characters. There are two parts to the new system: a
- “<span class="quote">string substitution map</span>” for doing
- “<span class="quote">essential</span>” replacements, and a
- “<span class="quote">character map</span>” that can optionally be disabled
- and enabled.</p><p>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 “<span class="quote">good</span>” roff
- equivalents for Unicode symbols and special
- characters.</p><p>Here are some details...</p><p>The previous manpages mechanism for replacing Unicode
- symbols and special characters with roff equivalents (the
- <code class="function">replace-entities</code> 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
- <span class="emphasis"><em>800</em></span> 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.</p><p>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
- “<span class="quote">Mathematical Operators</span>” 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 “<span class="quote">Dingbat</span>” block
- (141 characters in that that have roff equivalents or that
- can at least be “<span class="quote">degraded</span>” somewhat gracefully
- into roff).</p><p>So, the old <code class="function">replace-entities</code>
- mechanism was replaced with a completely different mechanism
- that is based on use of two “<span class="quote">maps</span>”: a
- “<span class="quote">substitution map</span>” and a “<span class="quote">character
- map</span>” (the latter in a format compliant with the XSLT
- 2.0 spec and therefore completely “<span class="quote">forward
- compatible</span>” with XSLT 2.0).</p><p>The substitution map is controlled through the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.string.subst.map.html"><em class="parameter"><code>man.string.subst.map</code></em></a> 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.</p><p>The “<span class="quote">character map</span>” 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 “<span class="quote">full</span>” character map that provides
- support for converting all 800 or so of the characters that
- have some reasonable groff equivalent.</p><p>The character-map mechanism is controlled through the
- following parameters:
- </p><div class="variablelist"><dl><dt><span class="term"><a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.enabled.html"><em class="parameter"><code>man.charmap.enabled</code></em></a></span></dt><dd><p>turns character-map support
- on/off</p></dd><dt><span class="term"><a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.use.subset.html"><em class="parameter"><code>man.charmap.use.subset</code></em></a></span></dt><dd><p>specifies that a subset of the character
- map is used instead of the full map</p></dd><dt><span class="term"><a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.subset.profile.html"><em class="parameter"><code>man.charmap.subset.profile</code></em></a></span></dt><dd><p>specifies profile of character-map
- subset</p></dd><dt><span class="term"><a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.charmap.uri.html"><em class="parameter"><code>man.charmap.uri</code></em></a></span></dt><dd><p>specifies an alternate character map to
- use instead of the “<span class="quote">standard</span>” character map
- provided in the distribution</p></dd></dl></div><p>
- </p></li><li><p>Implemented out-of-line handling of display of URLs
- for links (currently, only for <a href="http://www.docbook.org/tdg/en/html/ulink.html"><code class="sgmltag-element">ulink</code></a>). This gives
- you three choices for handling of links:
- </p><div class="orderedlist"><ol type="1"><li><p>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.</p></li><li><p>Only list links. Links are not numbered, but an
- (unnumbered) list of links is added to the end of the
- document.</p></li><li><p>Suppress links. Don't number links and don't add
- any list of links to the end of the document.</p></li></ol></div><p>
- You can also choose whether links should be underlined. The
- default is “<span class="quote">the works</span>” -- list, number, and
- underline links. You can use the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.list.enabled.html"><em class="parameter"><code>man.links.list.enabled</code></em></a>, <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.are.numbered.html"><em class="parameter"><code>
- man.links.are.numbered</code></em></a>, and
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.are.underlined.html"><em class="parameter"><code>man.links.are.underlined</code></em></a> parameters
- to change the defaults. The default heading for the link
- list is REFERENCES. You can be change that using the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.links.list.heading.html"><em class="parameter"><code>man.links.list.heading</code></em></a>
- parameter.</p></li><li><p>Changed default output encoding to UTF-8. <span class="bold"><strong>This does not mean that man pages are output in
- raw UTF-8</strong></span>, because the character map is applied
- before final output, causing all UTF-8 characters covered in
- the map to be converted to roff equivalents.</p></li><li><p>Added support for processing <a href="http://www.docbook.org/tdg/en/html/refsect3.html"><code class="sgmltag-element">refsect3</code></a> and
- <a href="http://www.docbook.org/tdg/en/html/formalpara.html"><code class="sgmltag-element">formalpara</code></a> and nested <a href="http://www.docbook.org/tdg/en/html/refsection.html"><code class="sgmltag-element">refsection</code></a>
- elements, down to any arbitrary level of nesting.</p></li><li><p>Output of the <code class="literal">NAME</code> and
- <code class="literal">SYNOPSIS</code> and <code class="literal">AUTHOR</code>
- headings and the headings for admonitions (<a href="http://www.docbook.org/tdg/en/html/note.html"><code class="sgmltag-element">note</code></a>,
- <a href="http://www.docbook.org/tdg/en/html/caution.html"><code class="sgmltag-element">caution</code></a>, 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).</p></li><li><p>Re-worked mechanism for assembling page
- headers/footers (the contents of the <code class="literal">.TH</code>
- macro “<span class="quote">title line</span>”).</p><p>Here are some details...</p><p>All man pages contain a <code class="literal">.TH</code> roff
- macro whose contents are used for rendering the “<span class="quote">title
- line</span>” 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: </p><pre class="literallayout">
- 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</pre><p>And here are the terms with which the
- <code class="literal">groff_man(7)</code> man page refers to the
- various parts of the header/footer: </p><pre class="literallayout">
- title(section) extra3 title(section) <- header
- extra2 extra1 title(section) <- footer</pre><p> Or, using the names with which the <code class="literal">man(7)</code>
- man page refers to those same fields: </p><pre class="literallayout">
- title(section) manual title(section) <- page header
- source date title(section) <- page footer</pre><p>The easiest way to control the contents of those
- fields is to mark up your <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> content like
- the following (note that this is a “<span class="quote">minimal</span>”
- example). </p><pre class="programlisting">
- <refentry>
- <info>
- <date>2003-10-20</date> <a name="V1690_date-co"></a><img src="images/callouts/1.png" alt="1" border="0">
- </info>
- <refmeta>
- <refentrytitle>gtk-options</refentrytitle> <a name="V1690_title-co"></a><img src="images/callouts/2.png" alt="2" border="0">
- <manvolnum>7</manvolnum> <a name="V1690_manvolnum-co"></a><img src="images/callouts/3.png" alt="3" border="0">
- <refmiscinfo class="source-name">GTK+</refmiscinfo> <a name="V1690_source-name-co"></a><img src="images/callouts/4.png" alt="4" border="0">
- <refmiscinfo class="version">1.2</refmiscinfo> <a name="V1690_version-co"></a><img src="images/callouts/5.png" alt="5" border="0">
- <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> <a name="V1690_manual-co"></a><img src="images/callouts/6.png" alt="6" border="0">
- </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></pre><p>
- </p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><a name="V1690_date"></a><a href="#V1690_date-co"><img src="images/callouts/1.png" alt="1" border="0"></a> </td><td valign="top" align="left"><p>Sets the “<span class="quote">date</span>” part of the header/footer.</p></td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_title"></a><a href="#V1690_title-co"><img src="images/callouts/2.png" alt="2" border="0"></a> </td><td valign="top" align="left"><p>Sets the “<span class="quote">title</span>” part.</p></td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_manvolnum"></a><a href="#V1690_manvolnum-co"><img src="images/callouts/3.png" alt="3" border="0"></a> </td><td valign="top" align="left"><p>Sets the “<span class="quote">section</span>” part.</p></td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_source-name"></a><a href="#V1690_source-name-co"><img src="images/callouts/4.png" alt="4" border="0"></a> </td><td valign="top" align="left"><p>Sets the “<span class="quote">source name</span>” part.</p></td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_version"></a><a href="#V1690_version-co"><img src="images/callouts/5.png" alt="5" border="0"></a> </td><td valign="top" align="left"><p>Sets the “<span class="quote">version</span>” part.</p></td></tr><tr><td width="5%" valign="top" align="left"><a name="V1690_manual"></a><a href="#V1690_manual-co"><img src="images/callouts/6.png" alt="6" border="0"></a> </td><td valign="top" align="left"><p>Sets the “<span class="quote">manual</span>” part.</p></td></tr></table></div><p>
- </p><p>Below are explanations of the steps the stylesheets
- take to attempt to assemble and display
- “<span class="quote">good</span>” headers and footer. [In the
- descriptions, note that <em class="replaceable"><code>*info</code></em>
- is the <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> “<span class="quote">info</span>” child
- (whatever its name), and
- <em class="replaceable"><code>parentinfo</code></em> is the
- “<span class="quote">info</span>” child of its parent (again, whatever
- its name).]
- </p><div class="variablelist"><dl><dt><span class="term">extra1 field (date)</span></dt><dd><p>Content of the “<span class="quote">extra1</span>” field is
- what shows up in the <span class="bold"><strong>center
- footer</strong></span> position of each page. The
- <code class="literal">man(7)</code> man page describes it as
- “<span class="quote">the date of the last revision</span>”.</p><p>To provide this content, if the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.date.profile.enabled.html"><em class="parameter"><code>refentry.date.profile.enabled</code></em></a>
- is non-zero, the stylesheets check the value of
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.date.profile.html"><em class="parameter"><code>refentry.date.profile</code></em></a>.</p><p>Otherwise, by default, they check for a
- <a href="http://www.docbook.org/tdg/en/html/date.html"><code class="sgmltag-element">date</code></a> or <a href="http://www.docbook.org/tdg/en/html/pubdate.html"><code class="sgmltag-element">pubdate</code></a> not only in the
- <em class="replaceable"><code>*info</code></em> contents, but also in
- the <em class="replaceable"><code>parentinfo</code></em>
- contents.</p><p>If a date cannot be found, the stylesheets now
- automatically generate a localized “<span class="quote">long
- format</span>” date, ensuring that this field always
- has content in output.</p><p>However, if for some reason you want to suppress
- this field, you can do so by setting a non-zero value
- for <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.th.extra1.suppress.html"><em class="parameter"><code>man.th.extra1.suppress</code></em></a>.</p></dd><dt><span class="term">extra2 field (source)</span></dt><dd><p>On Linux systems and on systems with a modern
- groff, the content of the “<span class="quote">extra2</span>” field
- are what shows up in the <span class="bold"><strong>left
- footer</strong></span> position of each page.</p><p>The <code class="literal">man(7)</code> man page describes
- this as “<span class="quote">the source of the command</span>”, and
- provides the following examples:
- </p><div class="itemizedlist"><ul type="circle"><li><p>For binaries, use somwething like: GNU,
- NET-2, SLS Distribution, MCC Distribution.</p></li><li><p>For system calls, use the version of the
- kernel that you are currently looking at: Linux
- 0.99.11.</p></li><li><p>For library calls, use the source of the
- function: GNU, BSD 4.3, Linux DLL 4.4.1.</p></li></ul></div><p>
- </p><p>In practice, there are many pages that simply
- have a version number in the “<span class="quote">source</span>”
- field. So, it looks like what we have is a two-part
- field,
- <em class="replaceable"><code>Name</code></em> <em class="replaceable"><code>Version</code></em>,
- where:
- </p><div class="variablelist"><dl><dt><span class="term">Name</span></dt><dd><p>product name (e.g., BSD) or org. name
- (e.g., GNU)</p></dd><dt><span class="term">Version</span></dt><dd><p>version name</p></dd></dl></div><p>
- Each part is optional. If the
- <em class="replaceable"><code>Name</code></em> is a product name,
- then the <em class="replaceable"><code>Version</code></em> is
- probably the version of the product. Or there may be
- no <em class="replaceable"><code>Name</code></em>, in which case, if
- there is a <em class="replaceable"><code>Version</code></em>, it is
- probably the version of the item itself, not the
- product it is part of. Or, if the
- <em class="replaceable"><code>Name</code></em> is an organization
- name, then there probably will be no
- <em class="replaceable"><code>Version</code></em>.
- </p><p>To provide this content, if the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.source.name.profile.enabled.html"><em class="parameter"><code>refentry.source.name.profile.enabled</code></em></a>
- and
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.version.profile.enabled.html"><em class="parameter"><code>refentry.version.profile.enabled</code></em></a>
- parameter are non-zero, the stylesheets check the
- value of <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.source.name.profile.html"><em class="parameter"><code>refentry.source.name.profile</code></em></a>
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/refentry.version.profile.html"><em class="parameter"><code>refentry.version.profile</code></em></a>.</p><p>Otherwise, by default, they check the following
- places, in the following order:
- </p><div class="orderedlist"><ol type="1"><li><pre class="literallayout"><em class="replaceable"><code>*info</code></em>/<a href="http://www.docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a></pre></li><li><pre class="literallayout"><em class="replaceable"><code>*info</code></em>/<a href="http://www.docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a></pre></li><li><pre class="literallayout"><a href="http://www.docbook.org/tdg/en/html/refmeta.html"><code class="sgmltag-element">refmeta</code></a>/<a href="http://www.docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a>[@class = 'version']</pre></li><li><pre class="literallayout"><em class="replaceable"><code>parentinfo</code></em>/<a href="http://www.docbook.org/tdg/en/html/productnumber.html"><code class="sgmltag-element">productnumber</code></a></pre></li><li><pre class="literallayout"><em class="replaceable"><code>*info</code></em>/<a href="http://www.docbook.org/tdg/en/html/productname.html"><code class="sgmltag-element">productname</code></a></pre></li><li><pre class="literallayout"><em class="replaceable"><code>parentinfo</code></em>/<a href="http://www.docbook.org/tdg/en/html/productname.html"><code class="sgmltag-element">productname</code></a></pre></li><li><pre class="literallayout"><a href="http://www.docbook.org/tdg/en/html/refmeta.html"><code class="sgmltag-element">refmeta</code></a>/<a href="http://www.docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a></pre></li><li><p>[nothing found, so leave it empty]</p></li></ol></div><p>
- </p></dd><dt><span class="term">extra3 field</span></dt><dd><p>On Linux systems and on systems with a modern
- groff, the content of the “<span class="quote">extra3</span>” field
- are what shows up in the <span class="bold"><strong>center
- header</strong></span> position of each page. Some man
- pages have “<span class="quote">extra2</span>” content, some
- don't. If a particular man page has it, it is most
- often “<span class="quote">context</span>” 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 “<span class="quote">extra3</span>” field.</p><div class="orderedlist"><ol type="1"><li><pre class="literallayout"><em class="replaceable"><code>parentinfo</code></em>/<a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a></pre></li><li><pre class="literallayout">parent's <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a></pre></li><li><pre class="literallayout"><a href="http://www.docbook.org/tdg/en/html/refmeta.html"><code class="sgmltag-element">refmeta</code></a>/<a href="http://www.docbook.org/tdg/en/html/refmiscinfo.html"><code class="sgmltag-element">refmiscinfo</code></a></pre></li><li><p>[nothing found, so leave it empty]</p></li></ol></div></dd></dl></div><p>
- </p></li><li><p>Reworked <em class="replaceable"><code>*info</code></em> gathering. For
- each <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> found, the stylesheets now cache its
- <em class="replaceable"><code>*info</code></em> 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
- <em class="replaceable"><code>*info</code></em> nodes each time they are
- needed).</p></li><li><p>New option for breaking strings after forward
- slashes. This enables long URLs and pathnames to be broken
- across lines. Controlled through
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.break.after.slash.html"><em class="parameter"><code>man.break.after.slash</code></em></a> parameter.</p></li><li><p>Output for servicemark and trademark are now
- <code class="literal">(SM)</code> and <code class="literal">(TM)</code>. There is
- a groff <code class="literal">"\(tm"</code> escape, but output from that
- is not acceptable.</p></li><li><p>New option for controlling the length of the title
- part of the <code class="literal">.TH</code> title line. Controlled
- through the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.th.title.max.length.html"><em class="parameter"><code>man.th.title.max.length</code></em></a>
- parameter.</p></li><li><p>New option for specifying output encoding of each man
- page; controlled with
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.output.encoding.html"><em class="parameter"><code>man.output.encoding</code></em></a> (similar to the
- HTML <em class="parameter"><code>chunker.output.encoding </code></em>
- parameter).</p></li><li><p>New option for suppressing filename messages when
- generating output; controlled with
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.output.quietly.html"><em class="parameter"><code>man.output.quietly</code></em></a> (similar to the HTML
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.quietly.html"><em class="parameter"><code>chunk.quietly</code></em></a> parameter).</p></li><li><p>The text of cross-references to first-level
- <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> (<a href="http://www.docbook.org/tdg/en/html/refsect1.html"><code class="sgmltag-element">refsect1</code></a>, top-level
- <a href="http://www.docbook.org/tdg/en/html/refsection.html"><code class="sgmltag-element">refsection</code></a>, <a href="http://www.docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a>, and
- <a href="http://www.docbook.org/tdg/en/html/refsynopsisdiv.html"><code class="sgmltag-element">refsynopsisdiv</code></a>) are now capitalized.</p></li><li><p>Cross-references to <a href="http://www.docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a> now use the
- localized <code class="literal">NAME</code> title instead of using the
- first <a href="http://www.docbook.org/tdg/en/html/refname.html"><code class="sgmltag-element">refname</code></a> 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
- <code class="literal">NAME</code>. (It may actually make better sense to
- do it that way in HTML and FO output as well...)</p></li><li><p>Added support for processing <a href="http://www.docbook.org/tdg/en/html/funcparams.html"><code class="sgmltag-element">funcparams</code></a>.</p></li><li><p>Removed the space that was being output between
- <a href="http://www.docbook.org/tdg/en/html/funcdef.html"><code class="sgmltag-element">funcdef</code></a> and <a href="http://www.docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a>; example: was:
- <code class="literal">float rand (void)</code>; now:
- <code class="literal">float rand(void)</code></p></li><li><p>Turned off bold formatting for the <a href="http://www.docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a>
- element when it occurs within a <a href="http://www.docbook.org/tdg/en/html/funcdef.html"><code class="sgmltag-element">funcdef</code></a> or
- <a href="http://www.docbook.org/tdg/en/html/paramdef.html"><code class="sgmltag-element">paramdef</code></a></p></li><li><p>Corrected rendering of <a href="http://www.docbook.org/tdg/en/html/simplelist.html"><code class="sgmltag-element">simplelist</code></a>. Any
- <code class="literal"><simplelist type="inline"</code> instance
- is now rendered as a comma-separated list (also with an
- optional localized “<span class="quote">and</span>” or “<span class="quote">or</span>” before the last item -- see
- description elsewhere in these release notes). Any simplelist
- instance whose <code class="sgmltag-attribute">type</code> is not
- <code class="literal">inline</code> is rendered as a one-column vertical
- list (ignoring the values of the <code class="sgmltag-attribute">type</code> and <code class="sgmltag-attribute">columns</code> attributes if present)</p></li><li><p>Comment added at top of roff source for each page now
- includes DocBook XSL stylesheets version number (as in the
- HTML stylesheets)</p></li><li><p>Made change to prevent “<span class="quote">sticky</span>” fonts
- changes. Now, when the manpages stylesheets encounter node
- sets that need to be boldfaced or italicized, they put the
- <code class="literal">\fBfoo\fR</code> and <code class="literal">\fIbar\fR</code>
- groff bold/italic instructions separately around each node in
- the set.</p></li><li><p>synop.xsl: Boldface everything in
- <a href="http://www.docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">funcsynopsis</code></a> output except parameters (which are in
- ital). The <code class="literal">man(7)</code> man page says:
- </p><div class="blockquote"><blockquote class="blockquote"><p>For functions, the arguments are always specified
- using italics, even in the SYNOPSIS section, where the rest
- of the function is specified in bold.</p></blockquote></div><p>
- A look through the contents of the
- <code class="filename">man/man2</code> directory shows that most
- (all) existing pages do follow this “<span class="quote">everything in
- funcsynopsis bold</span>” rule. That means the
- <a href="http://www.docbook.org/tdg/en/html/type.html"><code class="sgmltag-element">type</code></a> content and any punctuation (parens,
- semicolons, <code class="sgmltag-element">vararg</code>s) also must be bolded.</p></li><li><p>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</p></li><li><p>Removed special handling of the <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a>
- element. That was hard-coded to cause anything marked up with
- the <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a> element to be output preceded by two
- backticks and followed by two apostrophes -- that is, that
- old-school kludge for generating “<span class="quote">curly</span>” 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
- <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a>. By default, <a href="http://www.docbook.org/tdg/en/html/quote.html"><code class="sgmltag-element">quote</code></a> content is
- output with localized quotation marks, which, depending on the
- locale, may or may not be left and right double quotation
- marks.</p></li><li><p>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 <code class="literal">\(oq</code> and <code class="literal">\(cq</code> roff
- escapes. If you want the old (broken) behavior, you need to
- manually change the mappings for those in the value of the
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.string.subst.map.html"><em class="parameter"><code>man.string.subst.map</code></em></a> parameter.</p></li><li><p>Removed <code class="filename">xref.xsl</code> file. Now, of the
- various cross-reference elements, only the <a href="http://www.docbook.org/tdg/en/html/ulink.html"><code class="sgmltag-element">ulink</code></a>
- 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.)</p></li><li><p>New option for making “<span class="quote">subheading dividers</span>” 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
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/manpages/man.subheading.divider.html"><em class="parameter"><code>man.subheading.divider</code></em></a>.</p></li><li><p>Fixed many places where too much space was being added
- between lines.</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e1625"></a>Release 1.68.1</h2></div></div></div><p>The release adds localization support for Farsi (thanks to
- Sina Heshmati) and improved support for the XLink-based DocBook NG
- <code class="sgmltag-element">db:link</code> 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.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e1634"></a>Release 1.68.0</h2></div></div></div><p>This release includes some features changes, particularly
- for FO/PDF output, and a number of bug fixes.
- </p><div class="itemizedlist"><a name="V1680_FO"></a><p class="title"><b>FO</b></p><ul type="disc"><li><p>Moved footnote properties to attribute-sets.</p></li><li><p>Added support for side floats, margin notes, and
- custom floats.</p></li><li><p>Added new parameters
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/body.start.indent.html"><em class="parameter"><code>body.start.indent</code></em></a> and
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/body.end.indent.html"><em class="parameter"><code>body.end.indent</code></em></a> to the
- <em class="parameter"><code>set.flow.properties template</code></em>.</p></li><li><p>Added support for <code class="sgmltag-attribute">xml:id</code></p></li><li><p>Added support for
- <a href="http://www.docbook.org/tdg/en/html/refdescriptor.html"><code class="sgmltag-element">refdescriptor</code></a>.</p></li><li><p>Added support for multiple <a href="http://www.docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a>s.</p></li><li><p>Added <em class="parameter"><code>index.entry.properties</code></em>
- attribute-set to support customization of index
- entries.</p></li><li><p>Added <em class="parameter"><code>set.flow.properties
- template</code></em> call to each <code class="sgmltag-element">fo:flow</code>
- to support customizations entry point.</p></li><li><p>Add support for <code class="literal">@floatstyle</code> in
- <a href="http://www.docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a></p></li><li><p>Moved hardcoded properties for index division titles
- to the <em class="parameter"><code>index.div.title.properties</code></em>
- attribute-set.</p></li><li><p>Added support for
- <code class="sgmltag-element">table-layout</code>="<code class="sgmltag-attvalue">auto</code>" for XEP.</p></li><li><p>Added <em class="parameter"><code>index.div.title.properties</code></em>
- attribute-set.</p></li><li><p><em class="parameter"><code>$verbose</code></em> parameter is now
- passed to most elements.</p></li><li><p>Added <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a> to
- <a href="http://www.docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> in <a href="http://www.docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a>, as it is
- permitted by the DocBook schema/DTD.</p></li><li><p>Added backmatter elements and
- <a href="http://www.docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a> to <a href="http://www.docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> in
- <a href="http://www.docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a>, since they are permitted by the
- DocBook schema/DTD.</p></li><li><p>Added <code class="sgmltag-attribute">mode</code>="<code class="sgmltag-attvalue">toc</code>" for
- <a href="http://www.docbook.org/tdg/en/html/simplesect.html"><code class="sgmltag-element">simplesect</code></a>, since it is now permitted in
- the <a href="http://www.docbook.org/tdg/en/html/toc.html"><code class="sgmltag-element">toc</code></a> if
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/simplesect.in.toc.html"><em class="parameter"><code>simplesect.in.toc</code></em></a> is set.</p></li><li><p>Moved hard-coded properties to
- <em class="parameter"><code>nongraphical.admonintion.properties</code></em>
- and <em class="parameter"><code>graphical.admonition.properties</code></em>
- attribute sets.</p></li><li><p>Added support for <code class="literal">sidebar-width</code> and
- <code class="literal">float-type</code> processing instructions in
- <a href="http://www.docbook.org/tdg/en/html/sidebar.html"><code class="sgmltag-element">sidebar</code></a>.</p></li><li><p>For tables with HTML markup elements, added support
- for <code class="literal">dbfo bgcolor</code> PI, the attribute-sets
- named <em class="parameter"><code>table.properties</code></em>,
- <em class="parameter"><code>informaltable.properties</code></em>,
- <em class="parameter"><code>table.table.properties</code></em>, and
- <em class="parameter"><code>table.cell.padding</code></em>. Also added
- support for the templates named
- <em class="parameter"><code>table.cell.properties</code></em> and
- <em class="parameter"><code>table.cell.block.properties</code></em> so that
- tabstyles can be implemented. Also added support for tables
- containing only <code class="sgmltag-element">tr</code> instead of
- <a href="http://www.docbook.org/tdg/en/html/tbody.html"><code class="sgmltag-element">tbody</code></a> with <code class="sgmltag-element">tr</code>.</p></li><li><p>Added new paramater
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/hyphenate.verbatim.characters.html"><em class="parameter"><code>hyphenate.verbatim.characters</code></em></a> 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.</p></li><li><p>Added <em class="parameter"><code>itemizedlist.label.markup</code></em> to enable
- selection of different bullet symbol. Also added several
- potential bullet characters, commented out by default.</p></li><li><p>Enabled all id's in XEP output for external olinking.</p></li></ul></div><p>
-
- </p><div class="itemizedlist"><a name="V1680_HTML"></a><p class="title"><b>HTML</b></p><ul type="disc"><li><p>Added support for
- <a href="http://www.docbook.org/tdg/en/html/refdescriptor.html"><code class="sgmltag-element">refdescriptor</code></a>.</p></li><li><p>Added support for multiple <a href="http://www.docbook.org/tdg/en/html/refnamediv.html"><code class="sgmltag-element">refnamediv</code></a>s.</p></li><li><p>Added support for <code class="sgmltag-attribute">xml:id</code></p></li><li><p><a href="http://www.docbook.org/tdg/en/html/refsynopsisdiv.html"><code class="sgmltag-element">refsynopsisdiv</code></a> as a section for
- counting section levels</p></li></ul></div><p>
- </p><div class="itemizedlist"><a name="V1680_images"></a><p class="title"><b>Images</b></p><ul type="disc"><li><p>Added new SVG admonition graphics and navigation images.</p></li></ul></div><p>
- </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e1872"></a>Release 1.67.2</h2></div></div></div><p>This release fixes a table bug introduced in the 1.67.1
- release.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e1877"></a>Release 1.67.1</h2></div></div></div><p>This release includes a number of bug fixes; for details,
- see the <a href="WhatsNew" target="_top">WhatsNew</a> file.</p><p>The following lists provide details about API and feature changes.
- </p><div class="itemizedlist"><a name="V1671_FO"></a><p class="title"><b>FO</b></p><ul type="disc"><li><p>Tables: Inherited cell properties are now passed to the
- <code class="literal">table.cell.properties</code> template so they can
- be overridden by a customization.</p></li><li><p>Tables: Added support for bgcolor PI on table row
- element.</p></li><li><p>TOCs: Added new parameter
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/simplesect.in.toc.html"><em class="parameter"><code>simplesect.in.toc</code></em></a>; default value of
- <code class="literal">0</code> causes simplesect to be omitted from TOCs; to
- cause <a href="http://www.docbook.org/tdg/en/html/simplesect.html"><code class="sgmltag-element">simplesect</code></a> to be included in TOCs, you
- must set the value of <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/simplesect.in.toc.html"><em class="parameter"><code>simplesect.in.toc</code></em></a> to
- <code class="literal">1</code>.Comment from Norm:
-
- </p><div class="blockquote"><blockquote class="blockquote"><p><span class="emphasis"><em>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.</em></span></p></blockquote></div><p>
- </p></li><li><p>Sections: Reverted change that caused a variable reference
- to be used in a template match and rewrote code to preserve
- intended semantics.</p></li><li><p>Lists: Added workaround to prevent "* 0.60 + 1em" garbage in
- list output from PassiveTeX</p></li><li><p>Moved the literal attributes from
- <em class="parameter"><code>component.title</code></em> to the
- <em class="parameter"><code>component.title.properties</code></em> attribute-set so
- they can be customized.</p></li><li><p>Lists: Added <a href="http://www.docbook.org/tdg/en/html/glossdef.html"><code class="sgmltag-element">glossdef</code></a>'s first
- <a href="http://www.docbook.org/tdg/en/html/para.html"><code class="sgmltag-element">para</code></a> to special handling in
- <code class="literal">fo:list-item-body</code>.</p></li></ul></div><p>
-
- </p><div class="itemizedlist"><a name="V1671_HTML"></a><p class="title"><b>HTML</b></p><ul type="disc"><li><p>TOCs: Added new parameter
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/simplesect.in.toc.html"><em class="parameter"><code>simplesect.in.toc</code></em></a>; for details, see
- the list of <a href="#V1671_FO" title="FO">FO</a> changes for this
- release.</p></li><li><p>Indexing: Added new parameter
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.prefer.titleabbrev.html"><em class="parameter"><code>index.prefer.titleabbrev</code></em></a>; when set to
- <code class="literal">1</code>, index references will use
- <a href="http://www.docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> instead of
- <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a> when available.</p></li></ul></div><p>
- </p><div class="itemizedlist"><p class="title"><b>HTML Help</b></p><ul type="disc"><li><p>Added support for generating windows-1252-encoded
- output using Saxon; for more details, see the list of <a href="#V1671_EXT" title="XSL Java extensions">XSL Java extensions</a> changes for this release.</p></li></ul></div><p>
- </p><div class="itemizedlist"><a name="V1671_MAN"></a><p class="title"><b>man pages</b></p><ul type="disc"><li><p>Replaced named/numeric character-entity references for
- non-breaking space with groff equivalent (backslash-tilde).</p></li></ul></div><p>
- </p><div class="itemizedlist"><a name="V1671_EXT"></a><p class="title"><b>XSL Java extensions</b></p><ul type="disc"><li><p>Saxon extensions: Added the
- <code class="classname">Windows1252</code> 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
- <span class="firstname">Pontus</span> <span class="surname">Haglund</span> and contributed to the
- DocBook community by Sectra AB, Sweden).</p><p>To use:
- </p><div class="orderedlist"><ol type="1"><li><p>Make sure that the Saxon 6.5.x jar file and the jar file for
- the DocBook XSL Java extensions are in your <code class="envar">CLASSPATH</code></p></li><li><p>Create a DocBook XSL customization layer -- a file named
- <code class="filename">mystylesheet.xsl</code> or whatever -- that, at a
- minimum, contains the following:
- </p><pre class="screen"> <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></pre><p>
- </p><p>Invoke Saxon with the
- <code class="literal">encoding.windows-1252</code> Java system property set
- to <code class="literal">com.nwalsh.saxon.Windows1252</code>; for example
- </p><pre class="screen"> java \
- -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
- com.icl.saxon.StyleSheet \
- mydoc.xml mystylesheet.xsl</pre><p>
-
- Or, for a more complete "real world" case showing other
- options you'll typically want to use:
- </p><pre class="screen"> 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</pre><p>
-
- In both cases, the "mystylesheet.xsl" file should be a
- DocBook customization layer containing the parameters
- show in step 2.</p></li></ol></div><p>
- </p></li><li><p>Saxon extensions: Removed Saxon 8 extensions from release package</p></li></ul></div><p>
- </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2044"></a>Release 1.67.0</h2></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>A number of important bug fixes, documented in <a href="WhatsNew" target="_top">WhatsNew</a>.</p></li><li><p>Added Saxon8 extensions</p></li><li><p>Enabled <code class="literal">dbfo table-width</code> on
- <a href="http://www.docbook.org/tdg/en/html/entrytbl.html"><code class="sgmltag-element">entrytbl</code></a> in FO output</p></li><li><p>Added support for <code class="literal">role=strong</code> on
- <a href="http://www.docbook.org/tdg/en/html/emphasis.html"><code class="sgmltag-element">emphasis</code></a> in FO output</p></li><li><p>Added new FO parameter
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/fo/hyphenate.verbatim.html"><em class="parameter"><code>hyphenate.verbatim</code></em></a> that can be used to turn
- on "intelligent" wrapping of verbatim environments.</p></li><li><p>Replaced all <code class="literal"><tt></tt></code> output with
- <code class="literal"><code></code></code></p></li><li><p>Changed <code class="literal">admon.graphic.width</code> template to a
- mode so that different admonitions can have different graphical
- widths.</p></li><li><p>Deprecated the HTML <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/shade.verbatim.html"><em class="parameter"><code>shade.verbatim</code></em></a>
- parameter (use CSS instead)</p></li><li><p>Wrapped ToC
- <a href="http://www.docbook.org/tdg/en/html/refentrytitle.html"><code class="sgmltag-element">refentrytitle</code></a>/<a href="http://www.docbook.org/tdg/en/html/refname.html"><code class="sgmltag-element">refname</code></a> and
- <a href="http://www.docbook.org/tdg/en/html/refpurpose.html"><code class="sgmltag-element">refpurpose</code></a> in span with class values. This
- makes it possible to style them using a CSS stylesheet.</p></li><li><p>Use <code class="literal">strong/em</code> instead of
- <code class="literal">b/i</code> in HTML output</p></li><li><p>Added support for converting <a href="http://www.docbook.org/tdg/en/html/Emphasis.html"><code class="sgmltag-element">Emphasis</code></a> to
- groff italic and <a href="http://www.docbook.org/tdg/en/html/Emphasis role='bold'.html"><code class="sgmltag-element">Emphasis role='bold'</code></a> to
- bold. Controlled by
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/emphasis.propagates.style.html"><em class="parameter"><code>emphasis.propagates.style</code></em></a> 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).</p></li><li><p><em class="parameter"><code>callout.graphics.number.limit.xml</code></em>
- param: Changed the default from <code class="literal">10</code> to
- <code class="literal">15</code>.</p></li><li><p><em class="parameter"><code>verbatim.properties</code></em>: Added
- <code class="literal">hyphenate=false</code></p></li><li><p>Saxon and Xalan Text.java extensions: Added support for
- <code class="methodname">URIResolver()</code> on insertfile href's</p></li><li><p>Added generated <code class="filename">RELEASE-NOTES.txt</code>
- file.</p></li><li><p>Added <code class="filename">INSTALL</code> file (executable file for
- generating catalog.xml)</p></li><li><p>Removed obsolete <code class="filename">tools</code> directory from
- package</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2175"></a>Release 1.66.1</h2></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>A number of important bug fixes, documented in <a href="WhatsNew" target="_top">WhatsNew</a>.
-</p></li><li><p>
-Now <code class="literal">xml:base</code> attributes that are generated by an
-XInclude processor are resolved for image files.
-</p></li><li><p>
-Rewrote olink templates to support several new features.
-</p><div class="itemizedlist"><ul type="circle"><li><p>
-Extended full olink support to FO output.
-</p></li><li><p>
-Add support for <code class="literal">xrefstyle</code> attribute in olinks.
-</p></li><li><p>
-New parameters to support new olink features:
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/insert.olink.page.number.html"><em class="parameter"><code>insert.olink.page.number</code></em></a>, <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/insert.olink.pdf.frag.html"><em class="parameter"><code>insert.olink.pdf.frag</code></em></a>,
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/olink.debug.html"><em class="parameter"><code>olink.debug</code></em></a>, <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/olink.lang.fallback.sequence.html"><em class="parameter"><code>olink.lang.fallback.sequence</code></em></a>, <em class="parameter"><code>olink.properties</code></em>,
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/prefer.internal.olink.html"><em class="parameter"><code>prefer.internal.olink</code></em></a>.
-See the reference page for each parameter for more
-information.</p></li></ul></div></li><li><p>
-Added <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.on.type.html"><em class="parameter"><code>index.on.type</code></em></a> parameter for new <code class="sgmltag-attribute">type</code>
-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 <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/index.on.role.html"><em class="parameter"><code>index.on.role</code></em></a>
-instead.
-</p></li><li><p>
-Added new
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/section.autolabel.max.depth.html"><em class="parameter"><code>section.autolabel.max.depth</code></em></a> parameter to turn off section numbering
-below a certain depth.
-This permits you to number major section levels and leave minor
-section levels unnumbered.</p></li><li><p>
-Added <em class="parameter"><code>footnote.sep.leader.properties</code></em> attribute set to format
-the line separating footnotes in printed output.
-</p></li><li><p>
-Added parameter <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/img.src.path.html"><em class="parameter"><code>img.src.path</code></em></a> 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.</p></li><li><p>
-Added new attribute-sets
-<em class="parameter"><code>informalequation.properties</code></em>,
-<em class="parameter"><code>informalexample.properties</code></em>,
-<em class="parameter"><code>informalfigure.properties</code></em>, and <em class="parameter"><code>informaltable.properties</code></em>,
-so each such element type can be formatted
-individually if needed.
-</p></li><li><p>
-Add <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/component.label.includes.part.label.html"><em class="parameter"><code>component.label.includes.part.label</code></em></a>
-parameter to add any part number to chapter, appendix
-and other component labels when
-the <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/label.from.part.html"><em class="parameter"><code>label.from.part</code></em></a> parameter is nonzero.
-This permits you to distinguish multiple chapters with the same
-chapter number in cross references and the TOC.</p></li><li><p>
-Added <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/chunk.separate.lots.html"><em class="parameter"><code>chunk.separate.lots</code></em></a> parameter for HTML output.
-This parameter lets you generate separate chunk files for each LOT
-(list of tables, list of figures, etc.).</p></li><li><p>Added several table features:</p><div class="itemizedlist"><ul type="circle"><li><p>
-Added <em class="parameter"><code>table.table.properties</code></em> attribute set to add
-properties to the fo:table element.
-</p></li><li><p>
-Added placeholder templates named <code class="literal">table.cell.properties</code>
-and <code class="literal">table.cell.block.properties</code> to enable adding properties
-to any <code class="sgmltag-element">fo:table-cell</code> or the cell's <code class="sgmltag-element">fo:block</code>, respectively.
- These templates are a start for implementing table styles.</p></li></ul></div></li><li><p>
-Added new attribute
-set <em class="parameter"><code>component.title.properties</code></em> for easy modifications of
-component's title formatting in FO output.
-</p></li><li><p>
-Added Saxon support for an <code class="sgmltag-attribute">encoding</code> attribute on the <a href="http://www.docbook.org/tdg/en/html/textdata.html"><code class="sgmltag-element">textdata</code></a> element. Added new parameter
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/textdata.default.encoding.html"><em class="parameter"><code>textdata.default.encoding</code></em></a> which specifies encoding when
-<code class="sgmltag-attribute">encoding</code> attribute on
-<a href="http://www.docbook.org/tdg/en/html/textdata.html"><code class="sgmltag-element">textdata</code></a> is missing.
-</p></li><li><p>
-Template <code class="literal">label.this.section</code> now controls whole
-section label, not only sub-label which corresponds to
-particular label. Former behaviour was IMHO bug as it was
-not usable.
-</p></li><li><p>
-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.
-</p></li><li><p>
-Added <code class="literal">intial.page.number</code> template to set the <code class="literal">initial-page-number
-property</code> for page sequences in print output.
-Customizing this template lets you change when page numbering restarts. This is similar to the <code class="literal">format.page.number</code> template that lets you change how the page number formatting changes in the output.
-</p></li><li><p>
-Added <code class="literal">force.page.count</code> template to set the force-page-count
-property for page sequences in print output.
-This is similar to the <code class="literal">format.page.number</code> template.
-</p></li><li><p>
-Sort language for localized index sorting in <code class="filename">autoidx-ng.xsl</code> is now taken from document
-lang, not from system environment.
-</p></li><li><p>
-Numbering and formatting of normal
-and ulink footnotes (if turned on) has been unified.
-Now ulink footnotes are mixed in with any other footnotes.</p></li><li><p>
-Added support for <code class="sgmltag-element">renderas</code> attribute in section and
-sect1 et al.
-This permits you to render a given section title as if it were a different level.</p></li><li><p>
-Added support for <a href="http://www.docbook.org/tdg/en/html/label.html"><code class="sgmltag-element">label</code></a> attribute in footnote to manually
-supply the footnote mark.
-</p></li><li><p>
-Added support for DocBook 4.3 <code class="sgmltag-element">corpcredit</code> element.
-</p></li><li><p>
-Added support for a <code class="literal">dbfo keep-together</code> 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.
-</p></li><li><p>
-For graphics files, made file extension matching case
-insensitive, and updated the list of graphics extensions.
-</p></li><li><p>
-Allow <a href="http://www.docbook.org/tdg/en/html/calloutlist.html"><code class="sgmltag-element">calloutlist</code></a> to have block content before
-the first callout
-</p></li><li><p>
-Added <code class="literal">dbfo-need</code> processing instruction to provide
-soft page breaks.
-</p></li><li><p>
-Added implementation of existing but unused
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/default.image.width.html"><em class="parameter"><code>default.image.width</code></em></a> parameter for graphics.
-</p></li><li><p>
-Support DocBook NG <code class="sgmltag-element">tag</code> inline element.
-</p></li><li><p>
-It appears that XEP now supports Unicode characters in
-bookmarks. There is no further need to strip accents from
-characters.
-</p></li><li><p>
-Make <a href="http://www.docbook.org/tdg/en/html/segmentedlist.html"><code class="sgmltag-element">segmentedlist</code></a> HTML markup
-more semantic and available to CSS styles.
-</p></li><li><p>
-Added <code class="literal">user.preroot</code> placeholder template to
-permit xsl-stylesheet and other PIs and comments to be
-output before the HTML root element.
-</p></li><li><p>
-Non-chunked legalnotice now gets an <a
-name="id"> element in HTML output
-so it can be referenced with xref or link.
-</p></li><li><p>
-In chunked HTML output, changed <code class="literal">link rel="home"</code> to <code class="literal">rel="start"</code>,
-and <code class="literal">link rel="previous"</code> to <code class="literal">rel="prev"</code>, per W3C HTML 4.01
-spec.
-</p></li><li><p>
-Added several patches to htmlhelp from W. Borgert
-</p></li><li><p>
-Added Bosnian locale file as common/bs.xml.
-</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2462"></a>Release 1.65.0</h2></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>A number of important bug fixes, documented in <a href="WhatsNew" target="_top">WhatsNew</a>.
-</p></li><li><p>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 <code class="function">exsl:node-set</code> to process
-the result.)
-</p></li><li><p>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).</p><p>In order to use this mechanism you must create customization
-layer which imports some base stylesheet (like
-<code class="filename">fo/docbook.xsl</code>,
-<code class="filename">html/chunk.xsl</code>) and then includes appropriate
-stylesheet with new indexing code
-(<code class="filename">fo/autoidx-ng.xsl</code> or
-<code class="filename">html/autoidx-ng.xsl</code>). For example:</p><pre class="programlisting"><xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version="1.0">
-
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
-<xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
-
-</xsl:stylesheet></pre><p>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.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2498"></a>Release 1.64.1</h2></div></div></div><div class="itemizedlist"><p>General bug fixes and improvements. Sorry about the failure to produce
-an updated release notes file for 1.62.0—1.63.2</p><ul type="disc"><li><p>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 <code class="filename">xalan2.jar</code>
-will work with older Xalan 2 implementations, <code class="filename">xalan25.jar</code>
-works with Xalan 2.5.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2513"></a>Release 1.61.0</h2></div></div></div><div class="itemizedlist"><p>Lots of bug fixes and improvements.</p><ul type="disc"><li><p>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
-</p></li><li><p>Added level 6 to test for <a href="http://www.docbook.org/tdg/en/html/section.html"><code class="sgmltag-element">section</code></a> 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.
-</p></li><li><p>Don't use SVG graphics if <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/use.svg.html"><em class="parameter"><code>use.svg</code></em></a>=0
-</p></li><li><p>Now uses number-and-title-template for sections
- only if <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/section.autolabel.html"><em class="parameter"><code>section.autolabel</code></em></a> is not zero.
-</p></li><li><p>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.
-</p></li><li><p>Corrected several references to parameter
- <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/qanda.defaultlabel.html"><em class="parameter"><code>qanda.defaultlabel</code></em></a> that were missing the "$".
-</p></li><li><p>Now accepts <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/admon.textlabel.html"><em class="parameter"><code>admon.textlabel</code></em></a> parameter to turn off
- Note, Warning, etc. label.
-</p></li><li><p>FeatReq #684561: support more XEP metadata
-</p></li><li><p>Added hyphenation support. Added support for <a href="http://www.docbook.org/tdg/en/html/coref.html"><code class="sgmltag-element">coref</code></a>.
-Added <a href="http://www.docbook.org/tdg/en/html/beginpage.html"><code class="sgmltag-element">beginpage</code></a> support. (does nothing; see TDG).
-</p></li><li><p>Added support for
-hyphenation-character, hyphenation-push-character-count, and
-hyphenation-remain-character-count
-</p></li><li><p>Added <em class="parameter"><code>root.properties</code></em>,
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/ebnf.assignment.html"><em class="parameter"><code>ebnf.assignment</code></em></a>,
-and <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/ebnf.statement.terminator.html"><em class="parameter"><code>ebnf.statement.terminator</code></em></a>
-</p></li><li><p>Support bgcolor PI in table cells; make sure
-rowsep and colsep don't have any effect on the last row or
-column
-</p></li><li><p>Handle <a href="http://www.docbook.org/tdg/en/html/othercredit.html"><code class="sgmltag-element">othercredit</code></a> on titlepage a little
-better
-</p></li><li><p>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.
-</p></li><li><p>Added definition of missing variable
-<em class="parameter"><code>collection</code></em>.
-</p></li><li><p>Make <a href="http://www.docbook.org/tdg/en/html/footnote.html"><code class="sgmltag-element">footnote</code></a> formatting 'normal' even when it
-occurs in a context that has special formatting
-</p></li><li><p>Added warning when <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/glossary.collection.html"><em class="parameter"><code>glossary.collection</code></em></a> is not
-blank, but it cannot open the specified file.
-</p></li><li><p>Pick up the frame attribute on <a href="http://www.docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a> and
-<a href="http://www.docbook.org/tdg/en/html/informaltable.html"><code class="sgmltag-element">informaltable</code></a>.
-</p></li><li><p><a href="http://www.docbook.org/tdg/en/html/indexdiv.html"><code class="sgmltag-element">indexdiv</code></a>/<a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>
-in non-autogenerated indexes are
-now picked up.
-</p></li><li><p>Removed (unused)
-component.title.properties
-</p></li><li><p>Move IDs from
-page-sequences down to titlepage blocks
-</p></li><li><p>Use
-proportional-column-width(1) on more <a href="http://www.docbook.org/tdg/en/html/table.html"><code class="sgmltag-element">table</code></a>s.
-</p><p>Use proportional-column-width() for
-header/footer tables; suppress relative-align when when
-using FOP
-</p></li><li><p>Check for <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/glossterm.auto.link.html"><em class="parameter"><code>glossterm.auto.link</code></em></a> when linking
-firstterms; don't output gl. prefix on glossterm links
-</p></li><li><p>Generate Part ToCs
-</p></li><li><p>Support <a href="http://www.docbook.org/tdg/en/html/glossary.html"><code class="sgmltag-element">glossary</code></a>, <a href="http://www.docbook.org/tdg/en/html/bibliography.html"><code class="sgmltag-element">bibliography</code></a>,
-and <a href="http://www.docbook.org/tdg/en/html/index.html"><code class="sgmltag-element">index</code></a> in component ToCs.
-</p></li><li><p>Refactored chunking code so that
-customization of chunk algorithm and chunk elements is more
-practical
-</p></li><li><p>Support <a href="http://www.docbook.org/tdg/en/html/textobject.html"><code class="sgmltag-element">textobject</code></a>/<a href="http://www.docbook.org/tdg/en/html/phrase.html"><code class="sgmltag-element">phrase</code></a>
-on <a href="http://www.docbook.org/tdg/en/html/inlinemediaobject.html"><code class="sgmltag-element">inlinemediaobject</code></a>.
-</p></li><li><p>Support 'start' PI on ordered lists
-</p></li><li><p>Fixed test of $toc PI to turn on qandaset TOC.
-</p></li><li><p>Added process.chunk.footnotes to sect2 through
-5 to fix bug of missing footnotes when chunk level greater
-than 1.
-</p></li><li><p>Added
-paramater <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/toc.max.depth.html"><em class="parameter"><code>toc.max.depth</code></em></a> which controls maximal depth of ToC
-as requested by PHP-DOC group.
-</p></li><li><p>Exempted <a href="http://www.docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> from preamble processing in
-lists, and fixed variablelist preamble code to use the same
-syntax as the other lists.
-</p></li><li><p>Added support for elements between variablelist
-and first varlistentry since DocBook 4.2 supports that now.
-</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2703"></a>Release 1.60.1</h2></div></div></div><div class="itemizedlist"><p>Lots of bug fixes.</p><ul type="disc"><li><p>The format of the <code class="filename">titlepage.templates.xml</code> 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:</p><pre class="programlisting"><t:titlepage element="article" wrapper="fo:block"></pre><p>is now:</p><pre class="programlisting"><t:titlepage t:element="article" t:wrapper="fo:block"></pre><p>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 “<span class="quote">fo:</span>” qualified:</p><pre class="programlisting"><title named-template="component.title"
- param:node="ancestor-or-self::article[1]"
- fo:text-align="center"
- fo:keep-with-next="always"
- fo:font-size="&hsize5;"
- fo:font-weight="bold"
- fo:font-family="{$title.font.family}"/></pre><p>are now unqualified:</p><pre class="programlisting"><title t:named-template="component.title"
- param:node="ancestor-or-self::article[1]"
- text-align="center"
- keep-with-next="always"
- font-size="&hsize5;"
- font-weight="bold"
- font-family="{$title.font.family}"/></pre><p>The <code class="sgmltag-element">t:titlepage</code> and <code class="sgmltag-element">t:titlepage-content</code>
-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 “<span class="quote">recto</span>”
-titlepage centered by specifying the font and alignment on the those elements:</p><pre class="programlisting"><t:titlepage t:element="article" t:wrapper="fo:block"
- font-family="{$title.font.family}">
-
- <t:titlepage-content t:side="recto"
- text-align="center"></pre></li><li><p>Support use of <a href="http://www.docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> in running
-headers and footers.
-</p></li><li><p>Added (experimental) <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/xref.with.number.and.title.html"><em class="parameter"><code>xref.with.number.and.title</code></em></a>
-parameter to enable number/title cross references even when the
-default would
-be just the number.
-</p></li><li><p>Generate <a href="http://www.docbook.org/tdg/en/html/part.html"><code class="sgmltag-element">part</code></a> ToCs if they're requested.
-</p></li><li><p>Use proportional-column-width() in header/footer tables.
-</p></li><li><p>Handle alignment correctly when <a href="http://www.docbook.org/tdg/en/html/screenshot.html"><code class="sgmltag-element">screenshot</code></a>
-wraps a graphic in a <a href="http://www.docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>.
-</p></li><li><p>Format <a href="http://www.docbook.org/tdg/en/html/chapter.html"><code class="sgmltag-element">chapter</code></a> and <a href="http://www.docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a>
-cross references consistently.
-</p></li><li><p>Attempt to support tables with multiple <a href="http://www.docbook.org/tdg/en/html/tgroup.html"><code class="sgmltag-element">tgroup</code></a>s
-in FO.
-</p></li><li><p>Output <code class="sgmltag-element">fo:table-columns</code> in
-<a href="http://www.docbook.org/tdg/en/html/simplelist.html"><code class="sgmltag-element">simplelist</code></a> tables.
-</p></li><li><p>Use <code class="filename">titlepage.templates.xml</code> for
-<a href="http://www.docbook.org/tdg/en/html/indexdiv.html"><code class="sgmltag-element">indexdiv</code></a> and <a href="http://www.docbook.org/tdg/en/html/glossdiv.html"><code class="sgmltag-element">glossdiv</code></a> formatting.
-</p></li><li><p>Improve support for new bibliography elements.
-</p></li><li><p>Added
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/footnote.number.format.html"><em class="parameter"><code>footnote.number.format</code></em></a>,
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.footnote.number.format.html"><em class="parameter"><code>table.footnote.number.format</code></em></a>,
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/footnote.number.symbols.html"><em class="parameter"><code>footnote.number.symbols</code></em></a>, and
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.footnote.number.symbols.html"><em class="parameter"><code>table.footnote.number.symbols</code></em></a> for better control of
-footnote markers.
-</p></li><li><p>Added <code class="sgmltag-element">glossentry.show.acronyms</code>.
-</p></li><li><p>Suppress the draft-mode page masters when
-<em class="parameter"><code>draft-mode</code></em> is “<span class="quote">no</span>”.
-</p></li><li><p>Make blank pages verso not recto. D'Oh!
-</p></li><li><p>Improved formatting of <a href="http://www.docbook.org/tdg/en/html/ulink.html"><code class="sgmltag-element">ulink</code></a> footnotes.
-</p></li><li><p>Fixed bugs in graphic width/height calculations.
-</p></li><li><p>Added class attributes to inline elements.
-</p></li><li><p>Don't add “<span class="quote">.html</span>” to the filenames identified
-with the “<span class="quote">dbhtml</span>” PI.
-</p></li><li><p>Don't force a ToC when sections contain <a href="http://www.docbook.org/tdg/en/html/refentry.html"><code class="sgmltag-element">refentry</code></a>s.
-</p></li><li><p>Make section title sizes a function of the
-<em class="parameter"><code>body.master.size</code></em>.
-</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2880"></a>Release 1.59.2</h2></div></div></div><div class="itemizedlist"><p>The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
-</p><ul type="disc"><li><p>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.
-</p></li><li><p>Output IDs for the first paragraphs in listitems.
-</p></li><li><p>Fixed some small bugs in the handling of page numbers in double-sided mode.
-</p></li><li><p>Attempt to prevent duplicated IDs from being produced when
-<code class="sgmltag-attribute">endterm</code> on <a href="http://www.docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> points
-to something with nested structure.
-</p></li><li><p>Fix aligment problems in <a href="http://www.docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a>s.
-</p></li><li><p>Output the type attribute on unordered lists (UL) in HTML only if
-the css.decoration parameter is true.
-</p></li><li><p>Calculate the font size in formal.title.properties so that it's 1.2 times
-the base font size, not a fixed "12pt".
-</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2916"></a>Release 1.59.1</h2></div></div></div><div class="itemizedlist"><p>The 1.59.1 fixes a few bugs.
-</p><ul type="disc"><li><p>Added Bulgarian localization.
-</p></li><li><p>Indexing improvements; localize book indexes to books but allow setindex
-to index an entire set.
-</p></li><li><p>The default value for rowsep and colsep is now "1" as per CALS.
-</p></li><li><p>Added support for <a href="http://www.docbook.org/tdg/en/html/titleabbrev.html"><code class="sgmltag-element">titleabbrev</code></a> (use them for cross
-references).
-</p></li><li><p>Improvements to <a href="http://www.docbook.org/tdg/en/html/mediaobject.html"><code class="sgmltag-element">mediaobject</code></a> for selecting print vs. online
-images.
-</p></li><li><p>Added seperate property sets for <a href="http://www.docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>s,
-<a href="http://www.docbook.org/tdg/en/html/example.html"><code class="sgmltag-element">example</code></a>s, <a href="http://www.docbook.org/tdg/en/html/equation.html"><code class="sgmltag-element">equation</code></a>s, <code class="sgmltag-element">tables</code>s,
-and <a href="http://www.docbook.org/tdg/en/html/procedure.html"><code class="sgmltag-element">procedure</code></a>s.
-</p></li><li><p>Make <a href="http://www.docbook.org/tdg/en/html/lineannotation.html"><code class="sgmltag-element">lineannotation</code></a>s italic.
-</p></li><li><p>Support <code class="sgmltag-attribute">xrefstyle</code> attribute.
-</p></li><li><p>Make <code class="sgmltag-attribute">endterm</code> on
-<a href="http://www.docbook.org/tdg/en/html/xref.html"><code class="sgmltag-element">xref</code></a> higher priority than
-<code class="sgmltag-attribute">xreflabel</code> target.
-</p></li><li><p>Glossary formatting improvements.
-</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e2988"></a>Release 1.58.0</h2></div></div></div><div class="itemizedlist"><p>The 1.58.0 adds some initial support for extensions in xsltproc, adds
-a few features, and fixes bugs.
-</p><ul type="disc"><li><p>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 <code class="filename">extensions/xsltproc/python/xslt.py</code>.
-</p></li><li><p>Fixed bugs in calculation of adjusted column widths to correct for rounding
-errors.
-</p></li><li><p>Support nested <a href="http://www.docbook.org/tdg/en/html/refsection.html"><code class="sgmltag-element">refsection</code></a> elements correctly.
-</p></li><li><p>Reworked <code class="literal">gentext.template</code> to take context into consideration.
-The name of elements in localization files is now an xpath-like context list, not
-just a simple name.
-</p></li><li><p>Made some improvements to bibliography formatting.
-</p></li><li><p>Improved graphical formatting of admonitions.
-</p></li><li><p>Added support for <a href="http://www.docbook.org/tdg/en/html/entrytbl.html"><code class="sgmltag-element">entrytbl</code></a>.
-</p></li><li><p>Support spanning index terms.
-</p></li><li><p>Support <a href="http://www.docbook.org/tdg/en/html/bibliosource.html"><code class="sgmltag-element">bibliosource</code></a>.
-</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e3036"></a>Release 1.57.0</h2></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>The 1.57.0 release wasn't documented here. Oops.
-</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e3043"></a>Release 1.56.0</h2></div></div></div><div class="itemizedlist"><p>The 1.56.0 release fixes bugs.
-</p><ul type="disc"><li><p>Reworked chunking. <span class="emphasis"><em>This will break all existing customizations
-layers that change the chunking algorithm.</em></span> If you're customizing chunking,
-look at the new “<span class="quote">content</span>” parameter that's passed to
-<code class="literal">process-chunk-element</code> and friends.
-</p></li><li><p>Support continued and inherited numeration in <a href="http://www.docbook.org/tdg/en/html/orderedlist.html"><code class="sgmltag-element">orderedlist</code></a>
-formatting for FOs.
-</p></li><li><p>Added Thai localization.
-</p></li><li><p>Tweaked stylesheet documentation stylesheets to link to TDG and
-the parameter references.
-</p></li><li><p>Allow title on tables of contents ("Table of Contents") to be optional.
-Added new keyword to <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/generate.toc.html"><em class="parameter"><code>generate.toc</code></em></a>.
-Support tables of contents on sections.
-</p></li><li><p>Made separate parameters for table borders and table cell borders:
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.frame.border.color.html"><em class="parameter"><code>table.frame.border.color</code></em></a>,
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.frame.border.style.html"><em class="parameter"><code>table.frame.border.style</code></em></a>,
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.frame.border.thickness.html"><em class="parameter"><code>table.frame.border.thickness</code></em></a>,
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.cell.border.color.html"><em class="parameter"><code>table.cell.border.color</code></em></a>,
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.cell.border.style.html"><em class="parameter"><code>table.cell.border.style</code></em></a>, and
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/table.cell.border.thickness.html"><em class="parameter"><code>table.cell.border.thickness</code></em></a>.
-</p></li><li><p>Suppress formatting of “<span class="quote">endofrange</span>” <a href="http://www.docbook.org/tdg/en/html/indexterm.html"><code class="sgmltag-element">indexterm</code></a>s.
-This is only half-right. They should generate a range, but I haven't figured out how
-to do that yet.
-</p></li><li><p>Support <a href="http://www.docbook.org/tdg/en/html/revdescription.html"><code class="sgmltag-element">revdescription</code></a>. (Bug #582192)
-</p></li><li><p>Added <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/default.float.class.html"><em class="parameter"><code>default.float.class</code></em></a> and fixed figure
-floats. (Bug #497603)
-</p></li><li><p>Fixed formatting of <a href="http://www.docbook.org/tdg/en/html/sbr.html"><code class="sgmltag-element">sbr</code></a> in FOs.
-</p></li><li><p>Added context to the “<span class="quote">missing template</span>” error message.
-</p></li><li><p>Process <a href="http://www.docbook.org/tdg/en/html/arg.html"><code class="sgmltag-element">arg</code></a> correctly in a <a href="http://www.docbook.org/tdg/en/html/group.html"><code class="sgmltag-element">group</code></a>.
-(Bug #605150)
-</p></li><li><p>Removed 'keep-with-next' from <em class="parameter"><code>formal.title.properties</code></em>
-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.
-</p></li><li><p>Wrap “<span class="quote">url()</span>” around external-destinations when appropriate.
-</p></li><li><p>Fixed typo in compact list spacing. (Bug #615464)
-</p></li><li><p>Removed spurious hash in anchor name. (Bug #617717)
-</p></li><li><p>Address is now displayed verbatim on title pages. (Bug #618600)
-</p></li><li><p>The <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/bridgehead.in.toc.html"><em class="parameter"><code>bridgehead.in.toc</code></em></a> parameter is now properly
-supported.
-</p></li><li><p>Improved effectiveness of HTML cleanup by increasing the number
-of places where it is used. Improve use of HTML cleanup in XHTML stylesheets.
-</p></li><li><p>Support table of contents for <a href="http://www.docbook.org/tdg/en/html/appendix.html"><code class="sgmltag-element">appendix</code></a> in
-<a href="http://www.docbook.org/tdg/en/html/article.html"><code class="sgmltag-element">article</code></a>. (Bug #596599)
-</p></li><li><p>Don't duplicate footnotes in <a href="http://www.docbook.org/tdg/en/html/bibliography.html"><code class="sgmltag-element">bibliography</code></a>s and
-<a href="http://www.docbook.org/tdg/en/html/glossary.html"><code class="sgmltag-element">glossary</code></a>s. (Bug #583282)
-</p></li><li><p>Added <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/default.image.width.html"><em class="parameter"><code>default.image.width</code></em></a>. (Bug #516859)
-</p></li><li><p>Totally reworked <a href="http://www.docbook.org/tdg/en/html/funcsynopsis.html"><code class="sgmltag-element">funcsynopsis</code></a> code; it now
-supports a 'tabular' presentation style for 'wide' prototypes; see
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/funcsynopsis.tabular.threshold.html"><em class="parameter"><code>funcsynopsis.tabular.threshold</code></em></a>. (HTML only
-right now, I think, FO support, uh, real soon now.)
-</p></li><li><p>Reworked support for difference marking; toned down the colors a bit
-and added a “<span class="quote">system.head.content</span>” template so that the diff CSS
-wasn't overriding “<span class="quote">user.head.content</span>”. (Bug #610660)
-</p></li><li><p>Added call to the “<span class="quote">*.head.content</span>” elements when writing
-out long description chunks.
-</p></li><li><p>Make sure <a href="http://www.docbook.org/tdg/en/html/legalnotice.html"><code class="sgmltag-element">legalnotice</code></a> link is correct even when
-chunking to a different <a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/base.dir.html"><em class="parameter"><code>base.dir</code></em></a>.
-</p></li><li><p>Use CSS to set viewport characteristics if
-<a href="http://docbook.sourceforge.net/release/xsl/current/doc/html/css.decoration.html"><em class="parameter"><code>css.decoration</code></em></a> is non-zero, use div instead of p for making
-graphic a block element; make figure <a href="http://www.docbook.org/tdg/en/html/title.html"><code class="sgmltag-element">title</code></a>s the
-default alt
-text for images in a <a href="http://www.docbook.org/tdg/en/html/figure.html"><code class="sgmltag-element">figure</code></a>.</p></li><li><p>Added space-after to <em class="parameter"><code>list.block.spacing</code></em>.
-</p></li><li><p>Reworked section.level template to give “<span class="quote">correct</span>” answer
-instead of being off by one.
-</p></li><li><p>When processing tables, use the <code class="sgmltag-attribute">tabstyle</code>
-attribute as the division class.
-</p></li><li><p>Fixed bug in <code class="filename">html2xhtml.xsl</code> that was causing the
-XHTML chunker to output HTML instead of XHTML.
-</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e3265"></a>Older releases</h2></div></div></div><p>To view the release notes for older releases, see <a href="http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml" target="_top">http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml</a>. Be
- aware that there were no release notes for releases prior to the
- 1.50.0 release.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="dot0"></a>About dot-zero releases</h2></div></div></div><p>DocBook Project “<span class="quote">dot zero</span>” releases should be
- considered <span class="emphasis"><em>experimental</em></span> and are always
- followed by stable “<span class="quote">dot one</span>” releases, usually within
- two or three weeks. Please help to ensure the stability of
- “<span class="quote">dot one</span>” releases by carefully testing each
- “<span class="quote">dot zero</span>” release and reporting back about any
- problems you find. </p><p>It is not recommended that you use a “<span class="quote">dot zero</span>”
- release in a production system, or package it for an OS
- distro. Instead, you should wait for the “<span class="quote">dot one</span>”
- version.</p></div></div></body></html>
\ No newline at end of file
+++ /dev/null
-DocBook XSL Stylesheet Release Notes
-
-DocBook Project Development Team
-
-$Id$
-
-2005-08-12
-
-------------------------------------------------------------------------------
-
-Table of Contents
-
-Release 1.69.1
-Release 1.69.0
-
- Common
- FO
- Help
- HTML
- man
-
-Release 1.68.1
-Release 1.68.0
-Release 1.67.2
-Release 1.67.1
-Release 1.67.0
-Release 1.66.1
-Release 1.65.0
-Release 1.64.1
-Release 1.61.0
-Release 1.60.1
-Release 1.59.2
-Release 1.59.1
-Release 1.58.0
-Release 1.57.0
-Release 1.56.0
-Older releases
-About dot-zero releases
-
-These are the release notes for the DocBook XSL Stylesheets. At a minimum,
-this file attempts to document changes to the public APIs, particularly to
-user-configurable parameters. This file also provides a high-level overview of
-the features added in each release.
-
-Bug fixes are (mostly) not documented here. For a complete list of changes,
-including descriptions of bug fixes, see the NEWS file, which is
-auto-generated from the checkin descriptions for changes in the project CVS
-repository.
-
-Release 1.69.1
-
-This release is a minor bug-fix update to the 1.69.0 release. Along with bug
-fixes, it includes one configuration-parameter change: The default value of
-the annotation.support parameter is now 0 (off). The reason for that change is
-that there have been reports that annotation handling is causing a significant
-performance degradation in processing of large documents with xsltproc.
-
-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, and 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, and 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 “ and ” 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:
-
- 1. 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.
-
- 2. Only list links. Links are not numbered, but an (unnumbered) list of
- links is added to the end of the document.
-
- 3. 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> 1
- </info>
- <refmeta>
- <refentrytitle>gtk-options</refentrytitle> 2
- <manvolnum>7</manvolnum> 3
- <refmiscinfo class="source-name">GTK+</refmiscinfo> 4
- <refmiscinfo class="version">1.2</refmiscinfo> 5
- <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> 6
- </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>
-
- 1 Sets the "date" part of the header/footer.
-
- 2 Sets the "title" part.
-
- 3 Sets the "section" part.
-
- 4 Sets the "source name" part.
-
- 5 Sets the "version" part.
-
- 6 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:
-
- o For binaries, use somwething like: GNU, NET-2, SLS Distribution,
- MCC Distribution.
-
- o For system calls, use the version of the kernel that you are
- currently looking at: Linux 0.99.11.
-
- o 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:
-
- 1. *info/productnumber
-
- 2. *info/productnumber
-
- 3. refmeta/refmiscinfo[@class = 'version']
-
- 4. parentinfo/productnumber
-
- 5. *info/productname
-
- 6. parentinfo/productname
-
- 7. refmeta/refmiscinfo
-
- 8. [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.
-
- 1. parentinfo/title
-
- 2. parent's title
-
- 3. refmeta/refmiscinfo
-
- 4. [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 (`) 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 WhatsNew
-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
- FO 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 XSL Java extensions 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:
-
- 1. Make sure that the Saxon 6.5.x jar file and the jar file for the
- DocBook XSL Java extensions are in your CLASSPATH
-
- 2. 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 WhatsNew.
-
- * 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 WhatsNew.
-
- * Now xml:base attributes that are generated by an XInclude processor are
- resolved for image files.
-
- * Rewrote olink templates to support several new features.
-
- o Extended full olink support to FO output.
-
- o Add support for xrefstyle attribute in olinks.
-
- o 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:
-
- o Added table.table.properties attribute set to add properties to the
- fo:table element.
-
- o 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 WhatsNew.
-
- * Added a workaround to allow these stylesheets to process DocBook NG
- documents. (Its 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:
-
- <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version="1.0">
-
- <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
- <xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
-
- </xsl:stylesheet>
-
- 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.01.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:
-
- <t:titlepage element="article" wrapper="fo:block">
-
- is now:
-
- <t:titlepage t:element="article" t:wrapper="fo:block">
-
- 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:
-
- <title named-template="component.title"
- param:node="ancestor-or-self::article[1]"
- fo:text-align="center"
- fo:keep-with-next="always"
- fo:font-size="&hsize5;"
- fo:font-weight="bold"
- fo:font-family="{$title.font.family}"/>
-
- are now unqualified:
-
- <title t:named-template="component.title"
- param:node="ancestor-or-self::article[1]"
- text-align="center"
- keep-with-next="always"
- font-size="&hsize5;"
- font-weight="bold"
- font-family="{$title.font.family}"/>
-
- 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
-http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. 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.
-
-
+++ /dev/null
-<?xml version='1.0'?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
-<article>
- <articleinfo>
- <title>DocBook XSL Stylesheet Release Notes</title>
- <pubdate><?dbtimestamp format="Y-m-d"?></pubdate>
- <releaseinfo role="cvs">$Id$</releaseinfo>
- <corpauthor>DocBook Project Development Team</corpauthor>
- </articleinfo>
-
- <para>These are the release notes for the DocBook XSL Stylesheets.
- At a minimum, this file attempts to document changes to the public
- APIs, particularly to user-configurable parameters. This file also
- provides a high-level overview of the features added in each
- release.</para>
-
- <para>Bug fixes are (mostly) not documented here. For a complete
- list of changes, including descriptions of bug fixes, see the <ulink
- url="NEWS"/> file, which is auto-generated from the checkin
- descriptions for changes in the project CVS repository.</para>
-
- <section>
- <title>Release 1.69.1</title>
- <para>This release is a minor bug-fix update to the 1.69.0
- release. Along with bug fixes, it includes one
- configuration-parameter change: The default value of the
- <parameter>annotation.support</parameter> parameter is now
- <literal>0</literal> (off). The reason for that change is that
- there have been reports that <tag>annotation</tag> handling is
- causing a significant performance degradation in processing of
- large documents with <command>xsltproc</command>.</para>
- </section>
- <!-- end of notes for 1.69.1 release -->
-
- <section>
- <title>Release 1.69.0</title>
- <para>The release includes major feature changes,
- particularly in the <link linkend="V1690_MAN">manpages
- stylesheets</link>, as well as a large number of bug fixes.</para>
-
- <para>As with all DocBook Project <quote>dot zero</quote> releases, this is an
- <link linkend="dot0">experimental release </link>.</para>
-
- <section id="V1690_COMMON">
- <title>Common</title>
- <itemizedlist>
- <listitem>
- <para>This release adds localizations for the following
- languages:
- <simplelist type="inline">
- <?dbchoice choice="and"?>
- <member>Albanian</member>
- <member>Amharic</member>
- <member>Azerbaijani</member>
- <member>Hindi</member>
- <member>Irish (Gaelic)</member>
- <member>Gujarati</member>
- <member>Kannada</member>
- <member>Mongolian</member>
- <member>Oriya</member>
- <member>Punjabi</member>
- <member>Tagalog</member>
- <member>Tamil</member>
- <member>Welsh</member>
- </simplelist>.</para>
- </listitem>
- <listitem>
- <para>Added support for specifying number format for auto
- labels for <tag>chapter</tag>, <tag>appendix</tag>,
- <tag>part</tag>, and <tag>preface</tag>. Contolled with the
- <parameter>appendix.autolabel</parameter>,
- <parameter>chapter.autolabel</parameter>,
- <parameter>part.autolabel</parameter>, and
- <parameter>preface.autolabel</parameter> parameters.</para>
- </listitem>
- <listitem>
- <para>Added basic support for <tag>biblioref</tag> cross
- referencing.</para>
- </listitem>
- <listitem>
- <para>Added support for <tag class="attribute">align</tag>
- on <tag>caption</tag> in <tag>mediaobject</tag>.</para>
- </listitem>
- <listitem>
- <para>Added support for processing documents that use the
- DocBook V5 namespace.</para>
- </listitem>
- <listitem>
- <para>Added support for <tag>termdef</tag> and
- <tag>mathphrase</tag>.</para>
- </listitem>
- <listitem>
- <para>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
- <filename>tabular.xsl</filename> file: <literallayout
- class="monospaced"
- ><uri>http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl</uri
- ></literallayout></para>
- </listitem>
- <listitem>
- <para>A <tag>procedure</tag> without a <tag>title</tag> is
- now treated as an <quote>informal</quote> procedure (meaning
- that it is not added to any generated <quote>list of
- procedures</quote> and has no affect on numbering of
- generated labels for other procedures).</para>
- </listitem>
- <listitem>
- <para><tag>docname</tag> is no longer added to
- <tag>olink</tag> when pointing to a root element.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Added support for generation of choice separator in
- inline simplelist. This enables auto-generation of an
- appropriate localized <quote>choice separator</quote> (for
- example, <quote>and</quote> or <quote>or</quote>) before the
- final item in an inline <tag>simplelist</tag>.</para>
- <para>To indicate that you want a choice separator
- generated for a particular list, you need to put a processing
- instruction (PI) of the form
- <tag class="xmlpi">dbchoice choice="foo"</tag> as a
- child of the list. For example:
- <literallayout class="monospaced"
-> <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></literallayout>
-
- Output (for English):
- <blockquote>
- <para>Choose from ONE and only ONE of the
- following choices: A, B, or C.</para>
- </blockquote>
- As a temporary workaround for the fact that most of the
- DocBook non-English locale files don't have a localization for
- the word <quote>or</quote>, you can put in a literal string to
- be used; example for French: <tag
- class="pi">dbchoice choice="ou"</tag>. That is, use
- <quote>ou</quote> instead of <quote>or</quote>.</para>
- </listitem>
- </itemizedlist>
- </section>
- <section id="V1690_FO">
- <title>FO</title>
- <itemizedlist>
- <listitem>
- <para> Added <literal>content-type</literal> property to
- <literal>external-graphic</literal> element, based on
- <tag>imagedata</tag> <tag class="attribute">format</tag>
- attribute.</para>
- </listitem>
- <listitem>
- <para>Added support for generating
- <literal><rx:meta-field creator="$VERSION"/></literal>
- field for XEP output. This makes the DocBook XSL
- stylesheet version information available through the
- <guimenu>Document Properties</guimenu> menu in Acrobat
- Reader and other PDF viewers.</para>
- </listitem>
- <listitem>
- <para>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
- <tag class="attribute">class</tag> attribute on the
- <tag>trademark</tag> element, the HTML stylesheets would
- default to rendering a superscript <literal>TM
- </literal>symbol after the <tag>trademark</tag> contents,
- but the FO stylesheets would render nothing.</para>
- </listitem>
- <listitem>
- <para>Added support for generating XEP bookmarks for
- <tag>refentry</tag>.</para>
- </listitem>
- <listitem>
- <para>Added support for HTML markup <tag>table</tag> <tag
- class="attribute">border</tag> attribute, applied to each
- table cell.</para>
- </listitem>
- <listitem>
- <para>The <function>table.width</function> template can now
- sum column specs if none use <literal>%</literal> or
- <literal>*</literal>.</para>
- </listitem>
- <listitem>
- <para>Added <literal>fox:destination</literal> extension
- inside <literal>fox:outline</literal> to support linking to
- internal destinations.</para>
- </listitem>
- <listitem>
- <para>Added support for customizing
- <literal>abstract</literal> with property sets. Controlled
- with the <parameter>abstract.properties</parameter> and
- <parameter>abstract.title.properties</parameter>
- parameters.</para>
- </listitem>
- <listitem>
- <para>Add <tag>footnote</tag>s in <tag>table</tag> title to
- table footnote set, and add support for table footnotes to
- HTML table markup.</para>
- </listitem>
- <listitem>
- <para>Added support for <tag>title</tag> in
- <tag>glosslist</tag>.</para>
- </listitem>
- <listitem>
- <para>Added support for <tag>itemizedlist</tag> symbol
- <literal>none</literal>.</para>
- </listitem>
- <listitem>
- <para>Implemented the new
- <parameter>graphical.admonition.properties</parameter> and
- <parameter>nongraphical.admonition.properties</parameter>
- attribute sets.</para>
- </listitem>
- <listitem>
- <para>Added <tag class="attribute">id</tag> to
- <tag>formalpara</tag> and some other blocks that were
- missing it.</para>
- </listitem>
- <listitem>
- <para>Changed the anchor template to output
- <literal>fo:inline</literal> instead of
- <literal>fo:wrapper</literal>.</para>
- </listitem>
- <listitem>
- <para>Added support for <parameter>toc.max.depth</parameter>
- parameter.</para>
- </listitem>
- </itemizedlist>
- </section>
-
- <section id="V1690_HELP">
- <title>Help</title>
- <itemizedlist>
- <listitem>
- <para>Eclipse Help: Added support for generating olink
- database.</para>
- </listitem>
- </itemizedlist>
- </section>
-
- <section id="V1690_HTML">
- <title>HTML</title>
- <itemizedlist>
- <listitem>
- <para>Added a first cut at support in HTML output for
- DocBook 5 style <tag>annotation</tag>s. Controlled using the
- <parameter>annotation.support</parameter> parameter, and
- implemented using JavaScript and CSS styling. For more
- details, see the documentation for the
- <parameter>annotation.js</parameter>,
- <parameter>annotation.css</parameter>,
- <parameter>annotation.graphic.open</parameter>, and
- <parameter>annotation.graphic.close</parameter>
- parameters.</para>
- </listitem>
- <listitem>
- <para>Generate client-side image map for
- <tag>imageobjectco</tag> with areas using
- <literal>calspair</literal> units</para>
- </listitem>
- <listitem>
- <para>Added support for <tag
- class="xmlpi">img.src.path</tag> PI.</para>
- </listitem>
- <listitem>
- <para>Added support for passing
- <parameter>img.src.path</parameter> to DocBook Java XSLT
- image extensions when appropriate. Controlled using the
- <parameter>graphicsize.use.img.src.path</parameter>
- parameter.</para>
- </listitem>
- <listitem>
- <para>Added support for (not
- valid for DocBook 4) <tag class="attribute">xlink:href</tag>
- on <tag>area</tag> and (not valid for DocBook 4)
- <tag>alt</tag> in <tag>area</tag>.</para>
- </listitem>
- <listitem>
- <para>Added new parameter
- <parameter>default.table.frame</parameter> to control table
- framing if there is no <tag class="attribute">frame</tag>
- attribute on a table.</para>
- </listitem>
- <listitem>
- <para>Added initial, experimental support for generating
- content for the HTML <literal>title</literal> attribute from
- content of the <tag>alt</tag> element. This change adds
- support for the following inline elements only (none of them
- are block elements):
- <simplelist type="inline">
- <?dbchoice choice="and"?>
- <member><tag>abbrev</tag></member>
- <member><tag>accel</tag></member>
- <member><tag>acronym</tag></member>
- <member><tag>action</tag></member>
- <member><tag>application</tag></member>
- <member><tag>authorinitials</tag></member>
- <member><tag>beginpage</tag></member>
- <member><tag>citation</tag></member>
- <member><tag>citerefentry</tag></member>
- <member><tag>citetitle</tag></member>
- <member><tag>city</tag></member>
- <member><tag>classname</tag></member>
- <member><tag>code</tag></member>
- <member><tag>command</tag></member>
- <member><tag>computeroutput</tag></member>
- <member><tag>constant</tag></member>
- <member><tag>country</tag></member>
- <member><tag>database</tag></member>
- <member><tag>email</tag></member>
- <member><tag>envar</tag></member>
- <member><tag>errorcode</tag></member>
- <member><tag>errorname</tag></member>
- <member><tag>errortext</tag></member>
- <member><tag>errortype</tag></member>
- <member><tag>exceptionname</tag></member>
- <member><tag>fax</tag></member>
- <member><tag>filename</tag></member>
- <member><tag>firstname</tag></member>
- <member><tag>firstterm</tag></member>
- <member><tag>foreignphrase</tag></member>
- <member><tag>function</tag></member>
- <member><tag>glossterm</tag></member>
- <member><tag>guibutton</tag></member>
- <member><tag>guiicon</tag></member>
- <member><tag>guilabel</tag></member>
- <member><tag>guimenu</tag></member>
- <member><tag>guimenuitem</tag></member>
- <member><tag>guisubmenu</tag></member>
- <member><tag>hardware</tag></member>
- <member><tag>honorific</tag></member>
- <member><tag>interface</tag></member>
- <member><tag>interfacename</tag></member>
- <member><tag>keycap</tag></member>
- <member><tag>keycode</tag></member>
- <member><tag>keysym</tag></member>
- <member><tag>lineage</tag></member>
- <member><tag>lineannotation</tag></member>
- <member><tag>literal</tag></member>
- <member><tag>markup</tag></member>
- <member><tag>medialabel</tag></member>
- <member><tag>methodname</tag></member>
- <member><tag>mousebutton</tag></member>
- <member><tag>option</tag></member>
- <member><tag>optional</tag></member>
- <member><tag>otheraddr</tag></member>
- <member><tag>othername</tag></member>
- <member><tag>package</tag></member>
- <member><tag>parameter</tag></member>
- <member><tag>personname</tag></member>
- <member><tag>phone</tag></member>
- <member><tag>pob</tag></member>
- <member><tag>postcode</tag></member>
- <member><tag>productname</tag></member>
- <member><tag>productnumber</tag></member>
- <member><tag>prompt</tag></member>
- <member><tag>property</tag></member>
- <member><tag>quote</tag></member>
- <member><tag>refentrytitle</tag></member>
- <member><tag>remark</tag></member>
- <member><tag>replaceable</tag></member>
- <member><tag>returnvalue</tag></member>
- <member><tag>sgmltag</tag></member>
- <member><tag>shortcut</tag></member>
- <member><tag>state</tag></member>
- <member><tag>street</tag></member>
- <member><tag>structfield</tag></member>
- <member><tag>structname</tag></member>
- <member><tag>subscript</tag></member>
- <member><tag>superscript</tag></member>
- <member><tag>surname</tag></member>
- <member><tag>symbol</tag></member>
- <member><tag>systemitem</tag></member>
- <member><tag>tag</tag></member>
- <member><tag>termdef</tag></member>
- <member><tag>token</tag></member>
- <member><tag>trademark</tag></member>
- <member><tag>type</tag></member>
- <member><tag>uri</tag></member>
- <member><tag>userinput</tag></member>
- <member><tag>varname</tag></member>
- <member><tag>wordasword</tag></member>
- </simplelist>
- </para>
- </listitem>
- <listitem>
- <para>Added support for chunking <tag>revhistory</tag> into
- separate file (similar to the support for doing same with
- <tag>legalnotice</tag>). Patch from Thomas
- Schraitle. Controlled through <parameter>new
- generate.revhistory.link</parameter> parameter.</para>
- </listitem>
- <listitem>
- <para>l10n.xsl: Made language codes RFC compliant. Added a
- new boolean config parameter,
- <parameter>l10n.lang.value.rfc.compliant</parameter>. 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.</para>
- </listitem>
- </itemizedlist>
- </section>
- <section id="V1690_MAN">
- <title>man</title>
- <para>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.</para>
- <itemizedlist>
- <!-- ======================================================= -->
- <listitem>
- <para>New options for globally disabling/enabling
- hyphenation and justification:
- <parameter>man.justify</parameter> and
- <parameter>man.hyphenate</parameter>.</para>
- <para>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
- <quote>Hyphenation</quote> node from the groff info page:
- <blockquote>
- <para><emphasis>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.</emphasis></para>
- </blockquote>
- 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.</para>
- </listitem>
- <listitem>
- <para> 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
- <tag>classname</tag>, <tag>constant</tag>, <tag>envar</tag>,
- <tag>errorcode</tag>, <tag>option</tag>,
- <tag>replaceable</tag>, <tag>userinput</tag>,
- <tag>type</tag>, and <tag>varname</tag>, and for
- <tag>filenames</tag>, and for URLs from <tag>link</tag>. It
- can be (re)enabled using the
- <parameter>man.hyphenate.computer.inlines</parameter>,
- <parameter>man.hyphenate.filenames</parameter>, and
- <parameter>man.hyphenate.urls parameters</parameter>.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Implemented a new system for replacing Unicode
- characters. There are two parts to the new system: a
- <quote>string substitution map</quote> for doing
- <quote>essential</quote> replacements, and a
- <quote>character map</quote> that can optionally be disabled
- and enabled.</para>
- <para>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 <quote>good</quote> roff
- equivalents for Unicode symbols and special
- characters.</para>
- <para>Here are some details...</para>
- <para>The previous manpages mechanism for replacing Unicode
- symbols and special characters with roff equivalents (the
- <function>replace-entities</function> 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
- <emphasis>800</emphasis> 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.</para>
- <para>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
- <quote>Mathematical Operators</quote> 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 <quote>Dingbat</quote> block
- (141 characters in that that have roff equivalents or that
- can at least be <quote>degraded</quote> somewhat gracefully
- into roff).</para>
- <para>So, the old <function>replace-entities</function>
- mechanism was replaced with a completely different mechanism
- that is based on use of two <quote>maps</quote>: a
- <quote>substitution map</quote> and a <quote>character
- map</quote> (the latter in a format compliant with the XSLT
- 2.0 spec and therefore completely <quote>forward
- compatible</quote> with XSLT 2.0).</para>
- <para>The substitution map is controlled through the
- <parameter>man.string.subst.map</parameter> 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.</para>
-
- <para>The <quote>character map</quote> 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 <quote>full</quote> character map that provides
- support for converting all 800 or so of the characters that
- have some reasonable groff equivalent.</para>
-
- <para>The character-map mechanism is controlled through the
- following parameters:
- <variablelist>
- <varlistentry>
- <term><parameter>man.charmap.enabled</parameter></term>
- <listitem><para>turns character-map support
- on/off</para></listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>man.charmap.use.subset</parameter></term>
- <listitem><para>specifies that a subset of the character
- map is used instead of the full map</para></listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>man.charmap.subset.profile</parameter></term>
- <listitem><para>specifies profile of character-map
- subset</para></listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>man.charmap.uri</parameter></term>
- <listitem><para>specifies an alternate character map to
- use instead of the <quote>standard</quote> character map
- provided in the distribution</para></listitem>
- </varlistentry>
- </variablelist>
- </para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Implemented out-of-line handling of display of URLs
- for links (currently, only for <tag>ulink</tag>). This gives
- you three choices for handling of links:
- <orderedlist>
- <listitem>
- <para>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.</para>
- </listitem>
- <listitem>
- <para>Only list links. Links are not numbered, but an
- (unnumbered) list of links is added to the end of the
- document.</para>
- </listitem>
- <listitem>
- <para>Suppress links. Don't number links and don't add
- any list of links to the end of the document.</para>
- </listitem>
- </orderedlist>
- You can also choose whether links should be underlined. The
- default is <quote>the works</quote> -- list, number, and
- underline links. You can use the
- <parameter>man.links.list.enabled</parameter>, <parameter>
- man.links.are.numbered</parameter>, and
- <parameter>man.links.are.underlined</parameter> parameters
- to change the defaults. The default heading for the link
- list is REFERENCES. You can be change that using the
- <parameter>man.links.list.heading</parameter>
- parameter.</para>
- </listitem>
- <listitem>
- <para>Changed default output encoding to UTF-8. <emphasis
- role="bold">This does not mean that man pages are output in
- raw UTF-8</emphasis>, because the character map is applied
- before final output, causing all UTF-8 characters covered in
- the map to be converted to roff equivalents.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Added support for processing <tag>refsect3</tag> and
- <tag>formalpara</tag> and nested <tag>refsection</tag>
- elements, down to any arbitrary level of nesting.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Output of the <literal>NAME</literal> and
- <literal>SYNOPSIS</literal> and <literal>AUTHOR</literal>
- headings and the headings for admonitions (<tag>note</tag>,
- <tag>caution</tag>, 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).</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Re-worked mechanism for assembling page
- headers/footers (the contents of the <literal>.TH</literal>
- macro <quote>title line</quote>).</para>
-
- <para>Here are some details...</para>
-
- <para>All man pages contain a <literal>.TH</literal> roff
- macro whose contents are used for rendering the <quote>title
- line</quote> 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: <literallayout class="monospaced"
->
- 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</literallayout
-></para>
-
- <para>And here are the terms with which the
- <literal>groff_man(7)</literal> man page refers to the
- various parts of the header/footer: <literallayout class="monospaced"
->
- title(section) extra3 title(section) <- header
- extra2 extra1 title(section) <- footer</literallayout
-></para>
- <para> Or, using the names with which the <literal>man(7)</literal>
- man page refers to those same fields: <literallayout class="monospaced"
-
->
- title(section) manual title(section) <- page header
- source date title(section) <- page footer</literallayout
-></para>
-
- <para>The easiest way to control the contents of those
- fields is to mark up your <tag>refentry</tag> content like
- the following (note that this is a <quote>minimal</quote>
- example). <programlisting
->
- <refentry>
- <info>
- <date>2003-10-20</date> <co id="V1690_date-co" linkends="V168_date"/>
- </info>
- <refmeta>
- <refentrytitle>gtk-options</refentrytitle> <co id="V1690_title-co" linkends="V168_title"/>
- <manvolnum>7</manvolnum> <co id="V1690_manvolnum-co" linkends="V168_manvolnum"/>
- <refmiscinfo class="source-name">GTK+</refmiscinfo> <co id="V1690_source-name-co" linkends="V168_source-name"/>
- <refmiscinfo class="version">1.2</refmiscinfo> <co id="V1690_version-co" linkends="V168_dversion"/>
- <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> <co id="V1690_manual-co" linkends="V168_manual"/>
- </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></programlisting>
- <calloutlist>
- <callout arearefs="V1690_date-co" id="V1690_date">
- <para>Sets the <quote>date</quote> part of the header/footer.</para>
- </callout>
- <callout arearefs="V1690_title-co" id="V1690_title">
- <para>Sets the <quote>title</quote> part.</para>
- </callout>
- <callout arearefs="V1690_manvolnum-co" id="V1690_manvolnum">
- <para>Sets the <quote>section</quote> part.</para>
- </callout>
- <callout arearefs="V1690_source-name-co" id="V1690_source-name">
- <para>Sets the <quote>source name</quote> part.</para>
- </callout>
- <callout arearefs="V1690_version-co" id="V1690_version">
- <para>Sets the <quote>version</quote> part.</para>
- </callout>
- <callout arearefs="V1690_manual-co" id="V1690_manual">
- <para>Sets the <quote>manual</quote> part.</para>
- </callout>
- </calloutlist>
- </para>
- <para>Below are explanations of the steps the stylesheets
- take to attempt to assemble and display
- <quote>good</quote> headers and footer. [In the
- descriptions, note that <replaceable>*info</replaceable>
- is the <tag>refentry</tag> <quote>info</quote> child
- (whatever its name), and
- <replaceable>parentinfo</replaceable> is the
- <quote>info</quote> child of its parent (again, whatever
- its name).]
- <variablelist>
- <varlistentry>
- <term>extra1 field (date)</term>
- <listitem>
- <para>Content of the <quote>extra1</quote> field is
- what shows up in the <emphasis role="bold">center
- footer</emphasis> position of each page. The
- <literal>man(7)</literal> man page describes it as
- <quote>the date of the last revision</quote>.</para>
- <para>To provide this content, if the
- <parameter>refentry.date.profile.enabled</parameter>
- is non-zero, the stylesheets check the value of
- <parameter>refentry.date.profile</parameter>.</para>
- <para>Otherwise, by default, they check for a
- <tag>date</tag> or <tag>pubdate</tag> not only in the
- <replaceable>*info</replaceable> contents, but also in
- the <replaceable>parentinfo</replaceable>
- contents.</para>
- <para>If a date cannot be found, the stylesheets now
- automatically generate a localized <quote>long
- format</quote> date, ensuring that this field always
- has content in output.</para>
- <para>However, if for some reason you want to suppress
- this field, you can do so by setting a non-zero value
- for <parameter>man.th.extra1.suppress</parameter>.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>extra2 field (source)</term>
- <listitem>
- <para>On Linux systems and on systems with a modern
- groff, the content of the <quote>extra2</quote> field
- are what shows up in the <emphasis role="bold">left
- footer</emphasis> position of each page.</para>
-
- <para>The <literal>man(7)</literal> man page describes
- this as <quote>the source of the command</quote>, and
- provides the following examples:
- <itemizedlist>
- <listitem>
- <para>For binaries, use somwething like: GNU,
- NET-2, SLS Distribution, MCC Distribution.</para>
- </listitem>
- <listitem>
- <para>For system calls, use the version of the
- kernel that you are currently looking at: Linux
- 0.99.11.</para>
- </listitem>
- <listitem>
- <para>For library calls, use the source of the
- function: GNU, BSD 4.3, Linux DLL 4.4.1.</para>
- </listitem>
- </itemizedlist>
- </para>
-
- <para>In practice, there are many pages that simply
- have a version number in the <quote>source</quote>
- field. So, it looks like what we have is a two-part
- field,
- <replaceable>Name</replaceable> <replaceable>Version</replaceable>,
- where:
- <variablelist>
- <varlistentry>
- <term>Name</term>
- <listitem>
- <para>product name (e.g., BSD) or org. name
- (e.g., GNU)</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Version</term>
- <listitem>
- <para>version name</para>
- </listitem>
- </varlistentry>
- </variablelist>
- Each part is optional. If the
- <replaceable>Name</replaceable> is a product name,
- then the <replaceable>Version</replaceable> is
- probably the version of the product. Or there may be
- no <replaceable>Name</replaceable>, in which case, if
- there is a <replaceable>Version</replaceable>, it is
- probably the version of the item itself, not the
- product it is part of. Or, if the
- <replaceable>Name</replaceable> is an organization
- name, then there probably will be no
- <replaceable>Version</replaceable>.
- </para>
- <para>To provide this content, if the
- <parameter>refentry.source.name.profile.enabled</parameter>
- and
- <parameter>refentry.version.profile.enabled</parameter>
- parameter are non-zero, the stylesheets check the
- value of <parameter>refentry.source.name.profile</parameter>
- <parameter>refentry.version.profile</parameter>.</para>
-
- <para>Otherwise, by default, they check the following
- places, in the following order:
- <orderedlist>
- <listitem>
- <literallayout class="monospaced"
- ><replaceable>*info</replaceable
- >/<tag>productnumber</tag></literallayout>
- </listitem>
- <listitem>
- <literallayout class="monospaced"
- ><replaceable>*info</replaceable
- >/<tag>productnumber</tag></literallayout>
- </listitem>
- <listitem>
- <literallayout class="monospaced"
- ><tag>refmeta</tag
- >/<tag>refmiscinfo</tag
- >[@class = 'version']</literallayout>
- </listitem>
- <listitem>
- <literallayout class="monospaced"
- ><replaceable>parentinfo</replaceable
- >/<tag>productnumber</tag></literallayout>
- </listitem>
- <listitem>
- <literallayout class="monospaced"
- ><replaceable>*info</replaceable
- >/<tag>productname</tag></literallayout>
- </listitem>
- <listitem>
- <literallayout class="monospaced"
- ><replaceable>parentinfo</replaceable
- >/<tag>productname</tag></literallayout>
- </listitem>
- <listitem>
- <literallayout class="monospaced"
- ><tag>refmeta</tag
- >/<tag>refmiscinfo</tag></literallayout>
- </listitem>
- <listitem>
- <para>[nothing found, so leave it empty]</para>
- </listitem>
- </orderedlist>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>extra3 field</term>
- <listitem>
- <para>On Linux systems and on systems with a modern
- groff, the content of the <quote>extra3</quote> field
- are what shows up in the <emphasis role="bold">center
- header</emphasis> position of each page. Some man
- pages have <quote>extra2</quote> content, some
- don't. If a particular man page has it, it is most
- often <quote>context</quote> 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 <quote>extra3</quote> field.</para>
- <orderedlist>
- <listitem>
- <literallayout class="monospaced"
- ><replaceable>parentinfo</replaceable
- >/<tag>title</tag></literallayout>
- </listitem>
- <listitem>
- <literallayout class="monospaced"
- >parent's <tag>title</tag></literallayout>
- </listitem>
- <listitem>
- <literallayout class="monospaced"
- ><tag>refmeta</tag
- >/<tag>refmiscinfo</tag></literallayout>
- </listitem>
- <listitem>
- <para>[nothing found, so leave it empty]</para>
- </listitem>
- </orderedlist>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Reworked <replaceable>*info</replaceable> gathering. For
- each <tag>refentry</tag> found, the stylesheets now cache its
- <replaceable>*info</replaceable> 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
- <replaceable>*info</replaceable> nodes each time they are
- needed).</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>New option for breaking strings after forward
- slashes. This enables long URLs and pathnames to be broken
- across lines. Controlled through
- <parameter>man.break.after.slash</parameter> parameter.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Output for servicemark and trademark are now
- <literal>(SM)</literal> and <literal>(TM)</literal>. There is
- a groff <literal>"\(tm"</literal> escape, but output from that
- is not acceptable.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>New option for controlling the length of the title
- part of the <literal>.TH</literal> title line. Controlled
- through the <parameter>man.th.title.max.length</parameter>
- parameter.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>New option for specifying output encoding of each man
- page; controlled with
- <parameter>man.output.encoding</parameter> (similar to the
- HTML <parameter>chunker.output.encoding </parameter>
- parameter).</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>New option for suppressing filename messages when
- generating output; controlled with
- <parameter>man.output.quietly</parameter> (similar to the HTML
- <parameter>chunk.quietly</parameter> parameter).</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>The text of cross-references to first-level
- <tag>refentry</tag> (<tag>refsect1</tag>, top-level
- <tag>refsection</tag>, <tag>refnamediv</tag>, and
- <tag>refsynopsisdiv</tag>) are now capitalized.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Cross-references to <tag>refnamediv</tag> now use the
- localized <literal>NAME</literal> title instead of using the
- first <tag>refname</tag> 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
- <literal>NAME</literal>. (It may actually make better sense to
- do it that way in HTML and FO output as well...)</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Added support for processing <tag>funcparams</tag>.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Removed the space that was being output between
- <tag>funcdef</tag> and <tag>paramdef</tag>; example: was:
- <literal>float rand (void)</literal>; now:
- <literal>float rand(void)</literal></para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Turned off bold formatting for the <tag>type</tag>
- element when it occurs within a <tag>funcdef</tag> or
- <tag>paramdef</tag></para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Corrected rendering of <tag>simplelist</tag>. Any
- <literal><simplelist type="inline"</literal> instance
- is now rendered as a comma-separated list (also with an
- optional localized <quote>and</quote> or <quote>or</quote> before the last item -- see
- description elsewhere in these release notes). Any simplelist
- instance whose <tag class="attribute">type</tag> is not
- <literal>inline</literal> is rendered as a one-column vertical
- list (ignoring the values of the <tag
- class="attribute">type</tag> and <tag
- class="attribute">columns</tag> attributes if present)</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Comment added at top of roff source for each page now
- includes DocBook XSL stylesheets version number (as in the
- HTML stylesheets)</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Made change to prevent <quote>sticky</quote> fonts
- changes. Now, when the manpages stylesheets encounter node
- sets that need to be boldfaced or italicized, they put the
- <literal>\fBfoo\fR</literal> and <literal>\fIbar\fR</literal>
- groff bold/italic instructions separately around each node in
- the set.</para>
- </listitem>
- <listitem>
- <para>synop.xsl: Boldface everything in
- <tag>funcsynopsis</tag> output except parameters (which are in
- ital). The <literal>man(7)</literal> man page says:
- <blockquote>
- <para>For functions, the arguments are always specified
- using italics, even in the SYNOPSIS section, where the rest
- of the function is specified in bold.</para>
- </blockquote>
- A look through the contents of the
- <filename>man/man2</filename> directory shows that most
- (all) existing pages do follow this <quote>everything in
- funcsynopsis bold</quote> rule. That means the
- <tag>type</tag> content and any punctuation (parens,
- semicolons, <tag>vararg</tag>s) also must be bolded.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>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</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Removed special handling of the <tag>quote</tag>
- element. That was hard-coded to cause anything marked up with
- the <tag>quote</tag> element to be output preceded by two
- backticks and followed by two apostrophes -- that is, that
- old-school kludge for generating <quote>curly</quote> 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
- <tag>quote</tag>. By default, <tag>quote</tag> content is
- output with localized quotation marks, which, depending on the
- locale, may or may not be left and right double quotation
- marks.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>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 <literal>\(oq</literal> and <literal>\(cq</literal> roff
- escapes. If you want the old (broken) behavior, you need to
- manually change the mappings for those in the value of the
- <parameter>man.string.subst.map</parameter> parameter.</para>
- </listitem>
- <listitem>
- <para>Removed <filename>xref.xsl</filename> file. Now, of the
- various cross-reference elements, only the <tag>ulink</tag>
- 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.)</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>New option for making <quote>subheading dividers</quote> 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
- <parameter>man.subheading.divider</parameter>.</para>
- </listitem>
- <!-- ======================================================= -->
- <listitem>
- <para>Fixed many places where too much space was being added
- between lines.</para>
- </listitem>
- </itemizedlist>
- <!-- end of MAN changes for 1.69.0 release -->
- </section>
-</section>
- <!-- end of notes for 1.69.0 release -->
-
- <section>
- <title>Release 1.68.1</title>
- <para>The release adds localization support for Farsi (thanks to
- Sina Heshmati) and improved support for the XLink-based DocBook NG
- <sgmltag>db:link</sgmltag> 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.</para>
- </section>
- <!-- end of notes for 1.68.1 release -->
-
- <section>
- <title>Release 1.68.0</title>
- <para>This release includes some features changes, particularly
- for FO/PDF output, and a number of bug fixes.
- <itemizedlist id="V1680_FO">
- <title>FO</title>
- <listitem>
- <para>Moved footnote properties to attribute-sets.</para>
- </listitem>
- <listitem>
- <para>Added support for side floats, margin notes, and
- custom floats.</para>
- </listitem>
- <listitem>
- <para>Added new parameters
- <parameter>body.start.indent</parameter> and
- <parameter>body.end.indent</parameter> to the
- <parameter>set.flow.properties template</parameter>.</para>
- </listitem>
- <listitem>
- <para>Added support for <sgmltag
- class="attribute">xml:id</sgmltag></para>
- </listitem>
- <listitem>
- <para>Added support for
- <sgmltag>refdescriptor</sgmltag>.</para>
- </listitem>
- <listitem>
- <para>Added support for multiple <sgmltag>refnamediv</sgmltag>s.</para>
- </listitem>
- <listitem>
- <para>Added <parameter>index.entry.properties</parameter>
- attribute-set to support customization of index
- entries.</para>
- </listitem>
- <listitem>
- <para>Added <parameter>set.flow.properties
- template</parameter> call to each <sgmltag>fo:flow</sgmltag>
- to support customizations entry point.</para>
- </listitem>
- <listitem>
- <para>Add support for <literal>@floatstyle</literal> in
- <sgmltag>figure</sgmltag></para>
- </listitem>
- <listitem>
- <para>Moved hardcoded properties for index division titles
- to the <parameter>index.div.title.properties</parameter>
- attribute-set.</para>
- </listitem>
- <listitem>
- <para>Added support for
- <sgmltag>table-layout</sgmltag>="<sgmltag
- class="attvalue">auto</sgmltag>" for XEP.</para>
- </listitem>
- <listitem>
- <para>Added <parameter>index.div.title.properties</parameter>
- attribute-set.</para>
- </listitem>
- <listitem>
- <para><parameter>$verbose</parameter> parameter is now
- passed to most elements.</para>
- </listitem>
- <listitem>
- <para>Added <sgmltag>refentry</sgmltag> to
- <sgmltag>toc</sgmltag> in <sgmltag>part</sgmltag>, as it is
- permitted by the DocBook schema/DTD.</para>
- </listitem>
- <listitem>
- <para>Added backmatter elements and
- <sgmltag>article</sgmltag> to <sgmltag>toc</sgmltag> in
- <sgmltag>part</sgmltag>, since they are permitted by the
- DocBook schema/DTD.</para>
- </listitem>
- <listitem>
- <para>Added <sgmltag
- class="attribute">mode</sgmltag>="<sgmltag
- class="attvalue">toc</sgmltag>" for
- <sgmltag>simplesect</sgmltag>, since it is now permitted in
- the <sgmltag>toc</sgmltag> if
- <parameter>simplesect.in.toc</parameter> is set.</para>
- </listitem>
- <listitem>
- <para>Moved hard-coded properties to
- <parameter>nongraphical.admonintion.properties</parameter>
- and <parameter>graphical.admonition.properties</parameter>
- attribute sets.</para>
- </listitem>
- <listitem>
- <para>Added support for <literal>sidebar-width</literal> and
- <literal>float-type</literal> processing instructions in
- <sgmltag>sidebar</sgmltag>.</para>
- </listitem>
- <listitem>
- <para>For tables with HTML markup elements, added support
- for <literal>dbfo bgcolor</literal> PI, the attribute-sets
- named <parameter>table.properties</parameter>,
- <parameter>informaltable.properties</parameter>,
- <parameter>table.table.properties</parameter>, and
- <parameter>table.cell.padding</parameter>. Also added
- support for the templates named
- <parameter>table.cell.properties</parameter> and
- <parameter>table.cell.block.properties</parameter> so that
- tabstyles can be implemented. Also added support for tables
- containing only <sgmltag>tr</sgmltag> instead of
- <sgmltag>tbody</sgmltag> with <sgmltag>tr</sgmltag>.</para>
- </listitem>
- <listitem>
- <para>Added new paramater
- <parameter>hyphenate.verbatim.characters</parameter> 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.</para>
- </listitem>
- <listitem>
- <para>Added <parameter>itemizedlist.label.markup</parameter> to enable
- selection of different bullet symbol. Also added several
- potential bullet characters, commented out by default.</para>
- </listitem>
- <listitem>
- <para>Enabled all id's in XEP output for external olinking.</para>
- </listitem>
- </itemizedlist>
-
- <itemizedlist id="V1680_HTML">
- <title>HTML</title>
- <listitem>
- <para>Added support for
- <sgmltag>refdescriptor</sgmltag>.</para>
- </listitem>
- <listitem>
- <para>Added support for multiple <sgmltag>refnamediv</sgmltag>s.</para>
- </listitem>
- <listitem>
- <para>Added support for <sgmltag
- class="attribute">xml:id</sgmltag></para>
- </listitem>
- <listitem>
- <para><sgmltag>refsynopsisdiv</sgmltag> as a section for
- counting section levels</para>
- </listitem>
- </itemizedlist>
- <itemizedlist id="V1680_images">
- <title>Images</title>
- <listitem>
- <para>Added new SVG admonition graphics and navigation images.</para>
- </listitem>
- </itemizedlist>
- </para>
- </section>
- <!-- end of notes for 1.68.0 release -->
-
- <section>
- <title>Release 1.67.2</title>
- <para>This release fixes a table bug introduced in the 1.67.1
- release.</para>
- </section>
- <section>
- <title>Release 1.67.1</title>
- <para>This release includes a number of bug fixes; for details,
- see the <ulink url="WhatsNew"/> file.</para>
- <para>The following lists provide details about API and feature changes.
- <itemizedlist id="V1671_FO">
- <title>FO</title>
- <listitem>
- <para>Tables: Inherited cell properties are now passed to the
- <literal>table.cell.properties</literal> template so they can
- be overridden by a customization.</para>
- </listitem>
- <listitem>
- <para>Tables: Added support for bgcolor PI on table row
- element.</para>
- </listitem>
- <listitem>
- <para>TOCs: Added new parameter
- <parameter>simplesect.in.toc</parameter>; default value of
- <literal>0</literal> causes simplesect to be omitted from TOCs; to
- cause <sgmltag>simplesect</sgmltag> to be included in TOCs, you
- must set the value of <parameter>simplesect.in.toc</parameter> to
- <literal>1</literal>.Comment from Norm:
-
- <blockquote>
- <para><emphasis>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.</emphasis></para>
- </blockquote>
- </para>
- </listitem>
- <listitem>
- <para>Sections: Reverted change that caused a variable reference
- to be used in a template match and rewrote code to preserve
- intended semantics.</para>
- </listitem>
- <listitem>
- <para>Lists: Added workaround to prevent "* 0.60 + 1em" garbage in
- list output from PassiveTeX</para>
- </listitem>
- <listitem>
- <para>Moved the literal attributes from
- <parameter>component.title</parameter> to the
- <parameter>component.title.properties</parameter> attribute-set so
- they can be customized.</para>
- </listitem>
- <listitem>
- <para>Lists: Added <sgmltag>glossdef</sgmltag>'s first
- <sgmltag>para</sgmltag> to special handling in
- <literal>fo:list-item-body</literal>.</para>
- </listitem>
- </itemizedlist>
-
- <itemizedlist id="V1671_HTML">
- <title>HTML</title>
- <listitem>
- <para>TOCs: Added new parameter
- <parameter>simplesect.in.toc</parameter>; for details, see
- the list of <xref linkend="V1671_FO"/> changes for this
- release.</para>
- </listitem>
- <listitem>
- <para>Indexing: Added new parameter
- <parameter>index.prefer.titleabbrev</parameter>; when set to
- <literal>1</literal>, index references will use
- <sgmltag>titleabbrev</sgmltag> instead of
- <sgmltag>title</sgmltag> when available.</para>
- </listitem>
- </itemizedlist>
- <itemizedlist>
- <title>HTML Help</title>
- <listitem>
- <para>Added support for generating windows-1252-encoded
- output using Saxon; for more details, see the list of <xref
- linkend="V1671_EXT"/> changes for this release.</para>
- </listitem>
- </itemizedlist>
- <itemizedlist id="V1671_MAN">
- <title>man pages</title>
- <listitem>
- <para>Replaced named/numeric character-entity references for
- non-breaking space with groff equivalent (backslash-tilde).</para>
- </listitem>
- </itemizedlist>
- <itemizedlist id="V1671_EXT">
- <title>XSL Java extensions</title>
- <listitem>
- <para>Saxon extensions: Added the
- <classname>Windows1252</classname> 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
- <personname><firstname>Pontus</firstname>
- <surname>Haglund</surname></personname> and contributed to the
- DocBook community by Sectra AB, Sweden).</para>
- <para>To use:
- <orderedlist>
- <listitem>
- <para>Make sure that the Saxon 6.5.x jar file and the jar file for
- the DocBook XSL Java extensions are in your <envar>CLASSPATH</envar></para>
- </listitem>
- <listitem>
- <para>Create a DocBook XSL customization layer -- a file named
- <filename>mystylesheet.xsl</filename> or whatever -- that, at a
- minimum, contains the following:
- <screen format="linespecific"> <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></screen>
- </para>
- <para>Invoke Saxon with the
- <literal>encoding.windows-1252</literal> Java system property set
- to <literal>com.nwalsh.saxon.Windows1252</literal>; for example
- <screen format="linespecific"> java \
- -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
- com.icl.saxon.StyleSheet \
- mydoc.xml mystylesheet.xsl</screen>
-
- Or, for a more complete "real world" case showing other
- options you'll typically want to use:
- <screen format="linespecific"> 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</screen>
-
- In both cases, the "mystylesheet.xsl" file should be a
- DocBook customization layer containing the parameters
- show in step 2.</para>
- </listitem>
- </orderedlist>
- </para>
- </listitem>
- <listitem>
- <para>Saxon extensions: Removed Saxon 8 extensions from release package</para>
- </listitem>
- </itemizedlist>
- </para>
- </section>
-<section>
- <title>Release 1.67.0</title>
- <itemizedlist>
- <listitem>
- <para>A number of important bug fixes, documented in <ulink url="WhatsNew"/>.</para>
- </listitem>
- <listitem>
- <para>Added Saxon8 extensions</para>
- </listitem>
- <listitem>
- <para>Enabled <literal>dbfo table-width</literal> on
- <sgmltag>entrytbl</sgmltag> in FO output</para>
- </listitem>
- <listitem>
- <para>Added support for <literal>role=strong</literal> on
- <sgmltag>emphasis</sgmltag> in FO output</para>
- </listitem>
- <listitem>
- <para>Added new FO parameter
- <parameter>hyphenate.verbatim</parameter> that can be used to turn
- on "intelligent" wrapping of verbatim environments.</para>
- </listitem>
- <listitem>
- <para>Replaced all <literal><tt></tt></literal> output with
- <literal><code></code></literal></para>
- </listitem>
- <listitem>
- <para>Changed <literal>admon.graphic.width</literal> template to a
- mode so that different admonitions can have different graphical
- widths.</para>
- </listitem>
- <listitem>
- <para>Deprecated the HTML <parameter>shade.verbatim</parameter>
- parameter (use CSS instead)</para>
- </listitem>
- <listitem>
- <para>Wrapped ToC
- <sgmltag>refentrytitle</sgmltag>/<sgmltag>refname</sgmltag> and
- <sgmltag>refpurpose</sgmltag> in span with class values. This
- makes it possible to style them using a CSS stylesheet.</para>
- </listitem>
- <listitem>
- <para>Use <literal>strong/em</literal> instead of
- <literal>b/i</literal> in HTML output</para>
- </listitem>
- <listitem>
- <para>Added support for converting <sgmltag>Emphasis</sgmltag> to
- groff italic and <sgmltag>Emphasis role='bold'</sgmltag> to
- bold. Controlled by
- <parameter>emphasis.propagates.style</parameter> 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).</para>
- </listitem>
- <listitem>
- <para><parameter>callout.graphics.number.limit.xml</parameter>
- param: Changed the default from <literal>10</literal> to
- <literal>15</literal>.</para>
- </listitem>
- <listitem>
- <para><parameter>verbatim.properties</parameter>: Added
- <literal>hyphenate=false</literal></para>
- </listitem>
- <listitem>
- <para>Saxon and Xalan Text.java extensions: Added support for
- <methodname>URIResolver()</methodname> on insertfile href's</para>
- </listitem>
- <listitem>
- <para>Added generated <filename>RELEASE-NOTES.txt</filename>
- file.</para>
- </listitem>
- <listitem>
- <para>Added <filename>INSTALL</filename> file (executable file for
- generating catalog.xml)</para>
- </listitem>
- <listitem>
- <para>Removed obsolete <filename>tools</filename> directory from
- package</para>
- </listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.66.1</title>
- <itemizedlist>
-<listitem>
-<para>A number of important bug fixes, documented in <ulink url="WhatsNew"/>.
-</para>
-</listitem>
-<listitem>
-<para>
-Now <literal>xml:base</literal> attributes that are generated by an
-XInclude processor are resolved for image files.
-</para>
-</listitem>
-<listitem>
-<para>
-Rewrote olink templates to support several new features.
-</para>
-<itemizedlist>
-<listitem>
-<para>
-Extended full olink support to FO output.
-</para>
-</listitem>
-<listitem>
-<para>
-Add support for <literal>xrefstyle</literal> attribute in olinks.
-</para>
-</listitem>
-<listitem>
-<para>
-New parameters to support new olink features:
-<parameter>insert.olink.page.number</parameter>, <parameter>insert.olink.pdf.frag</parameter>,
-<parameter>olink.debug</parameter>, <parameter>olink.lang.fallback.sequence</parameter>, <parameter>olink.properties</parameter>,
-<parameter>prefer.internal.olink</parameter>.
-See the reference page for each parameter for more
-information.</para>
-</listitem>
-</itemizedlist>
-</listitem>
-<listitem>
-<para>
-Added <parameter>index.on.type</parameter> parameter for new <sgmltag
-class="attribute">type</sgmltag>
-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 <parameter>index.on.role</parameter>
-instead.
-</para>
-</listitem>
-<listitem>
-<para>
-Added new
-<parameter>section.autolabel.max.depth</parameter> parameter to turn off section numbering
-below a certain depth.
-This permits you to number major section levels and leave minor
-section levels unnumbered.</para>
-</listitem>
-<listitem>
-<para>
-Added <parameter>footnote.sep.leader.properties</parameter> attribute set to format
-the line separating footnotes in printed output.
-</para>
-</listitem>
-<listitem>
-<para>
-Added parameter <parameter>img.src.path</parameter> 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.</para>
-</listitem>
-<listitem>
-<para>
-Added new attribute-sets
-<parameter>informalequation.properties</parameter>,
-<parameter>informalexample.properties</parameter>,
-<parameter>informalfigure.properties</parameter>, and <parameter>informaltable.properties</parameter>,
-so each such element type can be formatted
-individually if needed.
-</para>
-</listitem>
-<listitem>
-<para>
-Add <parameter>component.label.includes.part.label</parameter>
-parameter to add any part number to chapter, appendix
-and other component labels when
-the <parameter>label.from.part</parameter> parameter is nonzero.
-This permits you to distinguish multiple chapters with the same
-chapter number in cross references and the TOC.</para>
-</listitem>
-<listitem>
-<para>
-Added <parameter>chunk.separate.lots</parameter> parameter for HTML output.
-This parameter lets you generate separate chunk files for each LOT
-(list of tables, list of figures, etc.).</para>
-</listitem>
-<listitem>
-<para>Added several table features:</para>
-<itemizedlist>
-<listitem>
-<para>
-Added <parameter>table.table.properties</parameter> attribute set to add
-properties to the fo:table element.
-</para>
-</listitem>
-<listitem>
-<para>
-Added placeholder templates named <literal>table.cell.properties</literal>
-and <literal>table.cell.block.properties</literal> to enable adding properties
-to any <sgmltag>fo:table-cell</sgmltag> or the cell's <sgmltag>fo:block</sgmltag>, respectively.
- These templates are a start for implementing table styles.</para>
-</listitem>
-</itemizedlist>
-</listitem>
-<listitem>
-<para>
-Added new attribute
-set <parameter>component.title.properties</parameter> for easy modifications of
-component's title formatting in FO output.
-</para>
-</listitem>
-<listitem>
-<para>
-Added Saxon support for an <sgmltag class="attribute">encoding</sgmltag> attribute on the <sgmltag class="element">textdata</sgmltag> element. Added new parameter
-<parameter>textdata.default.encoding</parameter> which specifies encoding when
-<sgmltag class="attribute">encoding</sgmltag> attribute on
-<sgmltag class="element">textdata</sgmltag> is missing.
-</para>
-</listitem>
-<listitem>
-<para>
-Template <literal>label.this.section</literal> now controls whole
-section label, not only sub-label which corresponds to
-particular label. Former behaviour was IMHO bug as it was
-not usable.
-</para>
-</listitem>
-<listitem>
-<para>
-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.
-</para>
-</listitem>
-<listitem>
-<para>
-Added <literal>intial.page.number</literal> template to set the <literal>initial-page-number
-property</literal> for page sequences in print output.
-Customizing this template lets you change when page numbering restarts. This is similar to the <literal>format.page.number</literal> template that lets you change how the page number formatting changes in the output.
-</para>
-</listitem>
-<listitem>
-<para>
-Added <literal>force.page.count</literal> template to set the force-page-count
-property for page sequences in print output.
-This is similar to the <literal>format.page.number</literal> template.
-</para>
-</listitem>
-<listitem>
-<para>
-Sort language for localized index sorting in <filename>autoidx-ng.xsl</filename> is now taken from document
-lang, not from system environment.
-</para>
-</listitem>
-<listitem>
-<para>
-Numbering and formatting of normal
-and ulink footnotes (if turned on) has been unified.
-Now ulink footnotes are mixed in with any other footnotes.</para>
-</listitem>
-<listitem>
-<para>
-Added support for <sgmltag>renderas</sgmltag> attribute in section and
-sect1 et al.
-This permits you to render a given section title as if it were a different level.</para>
-</listitem>
-<listitem>
-<para>
-Added support for <sgmltag>label</sgmltag> attribute in footnote to manually
-supply the footnote mark.
-</para>
-</listitem>
-<listitem>
-<para>
-Added support for DocBook 4.3 <sgmltag>corpcredit</sgmltag> element.
-</para>
-</listitem>
-<listitem>
-<para>
-Added support for a <literal>dbfo keep-together</literal> 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.
-</para>
-</listitem>
-<listitem>
-<para>
-For graphics files, made file extension matching case
-insensitive, and updated the list of graphics extensions.
-</para>
-</listitem>
-<listitem>
-<para>
-Allow <sgmltag>calloutlist</sgmltag> to have block content before
-the first callout
-</para>
-</listitem>
-<listitem>
-<para>
-Added <literal>dbfo-need</literal> processing instruction to provide
-soft page breaks.
-</para>
-</listitem>
-<listitem>
-<para>
-Added implementation of existing but unused
-<parameter>default.image.width</parameter> parameter for graphics.
-</para>
-</listitem>
-<listitem>
-<para>
-Support DocBook NG <sgmltag>tag</sgmltag> inline element.
-</para>
-</listitem>
-<listitem>
-<para>
-It appears that XEP now supports Unicode characters in
-bookmarks. There is no further need to strip accents from
-characters.
-</para>
-</listitem>
-<listitem>
-<para>
-Make <sgmltag>segmentedlist</sgmltag> HTML markup
-more semantic and available to CSS styles.
-</para>
-</listitem>
-<listitem>
-<para>
-Added <literal>user.preroot</literal> placeholder template to
-permit xsl-stylesheet and other PIs and comments to be
-output before the HTML root element.
-</para>
-</listitem>
-<listitem>
-<para>
-Non-chunked legalnotice now gets an <a
-name="id"> element in HTML output
-so it can be referenced with xref or link.
-</para>
-</listitem>
-<listitem>
-<para>
-In chunked HTML output, changed <literal>link rel="home"</literal> to <literal>rel="start"</literal>,
-and <literal>link rel="previous"</literal> to <literal>rel="prev"</literal>, per W3C HTML 4.01
-spec.
-</para>
-</listitem>
-<listitem>
-<para>
-Added several patches to htmlhelp from W. Borgert
-</para>
-</listitem>
-<listitem>
-<para>
-Added Bosnian locale file as common/bs.xml.
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.65.0</title>
-<itemizedlist>
-<listitem>
-<para>A number of important bug fixes, documented in <ulink url="WhatsNew"/>.
-</para>
-</listitem>
-<listitem>
-<para>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 <function>exsl:node-set</function> to process
-the result.)
-</para>
-</listitem>
-<listitem>
-<para>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).</para>
-<para>In order to use this mechanism you must create customization
-layer which imports some base stylesheet (like
-<filename>fo/docbook.xsl</filename>,
-<filename>html/chunk.xsl</filename>) and then includes appropriate
-stylesheet with new indexing code
-(<filename>fo/autoidx-ng.xsl</filename> or
-<filename>html/autoidx-ng.xsl</filename>). For example:</para>
-<programlisting><![CDATA[<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
- version="1.0">
-
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
-<xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
-
-</xsl:stylesheet>]]></programlisting>
-<para>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.</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.64.1</title>
-<itemizedlist>
-<para>General bug fixes and improvements. Sorry about the failure to produce
-an updated release notes file for 1.62.0—1.63.2</para>
-<listitem>
-<para>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 <filename>xalan2.jar</filename>
-will work with older Xalan 2 implementations, <filename>xalan25.jar</filename>
-works with Xalan 2.5.</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.61.0</title>
-<itemizedlist>
-<para>Lots of bug fixes and improvements.</para>
-<listitem>
-<para>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
-</para>
-</listitem>
-<listitem>
-<para>Added level 6 to test for <sgmltag>section</sgmltag> 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.
-</para>
-</listitem>
-<listitem>
-<para>Don't use SVG graphics if <parameter>use.svg</parameter>=0
-</para>
-</listitem>
-<listitem>
-<para>Now uses number-and-title-template for sections
- only if <parameter>section.autolabel</parameter> is not zero.
-</para>
-</listitem>
-<listitem>
-<para>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.
-</para>
-</listitem>
-<listitem>
-<para>Corrected several references to parameter
- <parameter>qanda.defaultlabel</parameter> that were missing the "$".
-</para>
-</listitem>
-<listitem>
-<para>Now accepts <parameter>admon.textlabel</parameter> parameter to turn off
- Note, Warning, etc. label.
-</para>
-</listitem>
-<listitem>
-<para>FeatReq #684561: support more XEP metadata
-</para>
-</listitem>
-<listitem>
-<para>Added hyphenation support. Added support for <sgmltag>coref</sgmltag>.
-Added <sgmltag>beginpage</sgmltag> support. (does nothing; see TDG).
-</para>
-</listitem>
-<listitem>
-<para>Added support for
-hyphenation-character, hyphenation-push-character-count, and
-hyphenation-remain-character-count
-</para>
-</listitem>
-<listitem>
-<para>Added <parameter>root.properties</parameter>,
-<parameter>ebnf.assignment</parameter>,
-and <parameter>ebnf.statement.terminator</parameter>
-</para>
-</listitem>
-<listitem>
-<para>Support bgcolor PI in table cells; make sure
-rowsep and colsep don't have any effect on the last row or
-column
-</para>
-</listitem>
-<listitem>
-<para>Handle <sgmltag>othercredit</sgmltag> on titlepage a little
-better
-</para>
-</listitem>
-<listitem>
-<para>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.
-</para>
-</listitem>
-<listitem>
-<para>Added definition of missing variable
-<parameter>collection</parameter>.
-</para>
-</listitem>
-<listitem>
-<para>Make <sgmltag>footnote</sgmltag> formatting 'normal' even when it
-occurs in a context that has special formatting
-</para>
-</listitem>
-<listitem>
-<para>Added warning when <parameter>glossary.collection</parameter> is not
-blank, but it cannot open the specified file.
-</para>
-</listitem>
-<listitem>
-<para>Pick up the frame attribute on <sgmltag>table</sgmltag> and
-<sgmltag>informaltable</sgmltag>.
-</para>
-</listitem>
-<listitem>
-<para><sgmltag>indexdiv</sgmltag>/<sgmltag>title</sgmltag>
-in non-autogenerated indexes are
-now picked up.
-</para>
-</listitem>
-<listitem>
-<para>Removed (unused)
-component.title.properties
-</para>
-</listitem>
-<listitem>
-<para>Move IDs from
-page-sequences down to titlepage blocks
-</para>
-</listitem>
-<listitem>
-<para>Use
-proportional-column-width(1) on more <sgmltag>table</sgmltag>s.
-</para>
-<para>Use proportional-column-width() for
-header/footer tables; suppress relative-align when when
-using FOP
-</para>
-</listitem>
-<listitem>
-<para>Check for <parameter>glossterm.auto.link</parameter> when linking
-firstterms; don't output gl. prefix on glossterm links
-</para>
-</listitem>
-<listitem>
-<para>Generate Part ToCs
-</para>
-</listitem>
-<listitem>
-<para>Support <sgmltag>glossary</sgmltag>, <sgmltag>bibliography</sgmltag>,
-and <sgmltag>index</sgmltag> in component ToCs.
-</para>
-</listitem>
-<listitem>
-<para>Refactored chunking code so that
-customization of chunk algorithm and chunk elements is more
-practical
-</para>
-</listitem>
-<listitem>
-<para>Support <sgmltag>textobject</sgmltag>/<sgmltag>phrase</sgmltag>
-on <sgmltag>inlinemediaobject</sgmltag>.
-</para>
-</listitem>
-<listitem>
-<para>Support 'start' PI on ordered lists
-</para>
-</listitem>
-<listitem>
-<para>Fixed test of $toc PI to turn on qandaset TOC.
-</para>
-</listitem>
-<listitem>
-<para>Added process.chunk.footnotes to sect2 through
-5 to fix bug of missing footnotes when chunk level greater
-than 1.
-</para>
-</listitem>
-<listitem>
-<para>Added
-paramater <parameter>toc.max.depth</parameter> which controls maximal depth of ToC
-as requested by PHP-DOC group.
-</para>
-</listitem>
-<listitem>
-<para>Exempted <sgmltag>titleabbrev</sgmltag> from preamble processing in
-lists, and fixed variablelist preamble code to use the same
-syntax as the other lists.
-</para>
-</listitem>
-<listitem>
-<para>Added support for elements between variablelist
-and first varlistentry since DocBook 4.2 supports that now.
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.60.1</title>
-<itemizedlist>
-<para>Lots of bug fixes.</para>
-<listitem>
-<para>The format of the <filename>titlepage.templates.xml</filename> 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:</para>
-<programlisting><![CDATA[<t:titlepage element="article" wrapper="fo:block">]]></programlisting>
-<para>is now:</para>
-<programlisting><![CDATA[<t:titlepage t:element="article" t:wrapper="fo:block">]]></programlisting>
-<para>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 <quote>fo:</quote> qualified:</para>
-<programlisting><![CDATA[<title named-template="component.title"
- param:node="ancestor-or-self::article[1]"
- fo:text-align="center"
- fo:keep-with-next="always"
- fo:font-size="&hsize5;"
- fo:font-weight="bold"
- fo:font-family="{$title.font.family}"/>]]></programlisting>
-<para>are now unqualified:</para>
-<programlisting><![CDATA[<title t:named-template="component.title"
- param:node="ancestor-or-self::article[1]"
- text-align="center"
- keep-with-next="always"
- font-size="&hsize5;"
- font-weight="bold"
- font-family="{$title.font.family}"/>]]></programlisting>
-<para>The <sgmltag>t:titlepage</sgmltag> and <sgmltag>t:titlepage-content</sgmltag>
-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 <quote>recto</quote>
-titlepage centered by specifying the font and alignment on the those elements:</para>
-<programlisting><t:titlepage t:element="article" t:wrapper="fo:block"
- font-family="{$title.font.family}">
-
- <t:titlepage-content t:side="recto"
- text-align="center"></programlisting>
-
-
-
-
-
-</listitem>
-<listitem>
-<para>Support use of <sgmltag>titleabbrev</sgmltag> in running
-headers and footers.
-</para>
-</listitem>
-<listitem>
-<para>Added (experimental) <parameter>xref.with.number.and.title</parameter>
-parameter to enable number/title cross references even when the
-default would
-be just the number.
-</para>
-</listitem>
-<listitem>
-<para>Generate <sgmltag>part</sgmltag> ToCs if they're requested.
-</para>
-</listitem>
-<listitem>
-<para>Use proportional-column-width() in header/footer tables.
-</para>
-</listitem>
-<listitem>
-<para>Handle alignment correctly when <sgmltag>screenshot</sgmltag>
-wraps a graphic in a <sgmltag>figure</sgmltag>.
-</para>
-</listitem>
-<listitem>
-<para>Format <sgmltag>chapter</sgmltag> and <sgmltag>appendix</sgmltag>
-cross references consistently.
-</para>
-</listitem>
-<listitem>
-<para>Attempt to support tables with multiple <sgmltag>tgroup</sgmltag>s
-in FO.
-</para>
-</listitem>
-<listitem>
-<para>Output <sgmltag>fo:table-columns</sgmltag> in
-<sgmltag>simplelist</sgmltag> tables.
-</para>
-</listitem>
-<listitem>
-<para>Use <filename>titlepage.templates.xml</filename> for
-<sgmltag>indexdiv</sgmltag> and <sgmltag>glossdiv</sgmltag> formatting.
-</para>
-</listitem>
-<listitem>
-<para>Improve support for new bibliography elements.
-</para>
-</listitem>
-<listitem>
-<para>Added
-<parameter>footnote.number.format</parameter>,
-<parameter>table.footnote.number.format</parameter>,
-<parameter>footnote.number.symbols</parameter>, and
-<parameter>table.footnote.number.symbols</parameter> for better control of
-footnote markers.
-</para>
-</listitem>
-<listitem>
-<para>Added <sgmltag>glossentry.show.acronyms</sgmltag>.
-</para>
-</listitem>
-<listitem>
-<para>Suppress the draft-mode page masters when
-<parameter>draft-mode</parameter> is <quote>no</quote>.
-</para>
-</listitem>
-<listitem>
-<para>Make blank pages verso not recto. D'Oh!
-</para>
-</listitem>
-<listitem>
-<para>Improved formatting of <sgmltag>ulink</sgmltag> footnotes.
-</para>
-</listitem>
-<listitem>
-<para>Fixed bugs in graphic width/height calculations.
-</para>
-</listitem>
-<listitem>
-<para>Added class attributes to inline elements.
-</para>
-</listitem>
-<listitem>
-<para>Don't add <quote>.html</quote> to the filenames identified
-with the <quote>dbhtml</quote> PI.
-</para>
-</listitem>
-<listitem>
-<para>Don't force a ToC when sections contain <sgmltag>refentry</sgmltag>s.
-</para>
-</listitem>
-<listitem>
-<para>Make section title sizes a function of the
-<parameter>body.master.size</parameter>.
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.59.2</title>
-<itemizedlist>
-<para>The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail.
-</para>
-<listitem>
-<para>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.
-</para>
-</listitem>
-<listitem>
-<para>Output IDs for the first paragraphs in listitems.
-</para>
-</listitem>
-<listitem>
-<para>Fixed some small bugs in the handling of page numbers in double-sided mode.
-</para>
-</listitem>
-<listitem>
-<para>Attempt to prevent duplicated IDs from being produced when
-<sgmltag class="attribute">endterm</sgmltag> on <sgmltag>xref</sgmltag> points
-to something with nested structure.
-</para>
-</listitem>
-<listitem>
-<para>Fix aligment problems in <sgmltag>equation</sgmltag>s.
-</para>
-</listitem>
-<listitem>
-<para>Output the type attribute on unordered lists (UL) in HTML only if
-the css.decoration parameter is true.
-</para>
-</listitem>
-<listitem>
-<para>Calculate the font size in formal.title.properties so that it's 1.2 times
-the base font size, not a fixed "12pt".
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.59.1</title>
-<itemizedlist>
-<para>The 1.59.1 fixes a few bugs.
-</para>
-<listitem>
-<para>Added Bulgarian localization.
-</para>
-</listitem>
-<listitem>
-<para>Indexing improvements; localize book indexes to books but allow setindex
-to index an entire set.
-</para>
-</listitem>
-<listitem>
-<para>The default value for rowsep and colsep is now "1" as per CALS.
-</para>
-</listitem>
-<listitem>
-<para>Added support for <sgmltag>titleabbrev</sgmltag> (use them for cross
-references).
-</para>
-</listitem>
-<listitem>
-<para>Improvements to <sgmltag>mediaobject</sgmltag> for selecting print vs. online
-images.
-</para>
-</listitem>
-<listitem>
-<para>Added seperate property sets for <sgmltag>figure</sgmltag>s,
-<sgmltag>example</sgmltag>s, <sgmltag>equation</sgmltag>s, <sgmltag>tables</sgmltag>s,
-and <sgmltag>procedure</sgmltag>s.
-</para>
-</listitem>
-<listitem>
-<para>Make <sgmltag>lineannotation</sgmltag>s italic.
-</para>
-</listitem>
-<listitem>
-<para>Support <sgmltag class="attribute">xrefstyle</sgmltag> attribute.
-</para>
-</listitem>
-<listitem>
-<para>Make <sgmltag class="attribute">endterm</sgmltag> on
-<sgmltag>xref</sgmltag> higher priority than
-<sgmltag class="attribute">xreflabel</sgmltag> target.
-</para>
-</listitem>
-<listitem>
-<para>Glossary formatting improvements.
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.58.0</title>
-<itemizedlist>
-<para>The 1.58.0 adds some initial support for extensions in xsltproc, adds
-a few features, and fixes bugs.
-</para>
-<listitem>
-<para>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 <filename>extensions/xsltproc/python/xslt.py</filename>.
-</para>
-</listitem>
-<listitem>
-<para>Fixed bugs in calculation of adjusted column widths to correct for rounding
-errors.
-</para>
-</listitem>
-<listitem>
-<para>Support nested <sgmltag>refsection</sgmltag> elements correctly.
-</para>
-</listitem>
-<listitem>
-<para>Reworked <literal>gentext.template</literal> to take context into consideration.
-The name of elements in localization files is now an xpath-like context list, not
-just a simple name.
-</para>
-</listitem>
-<listitem>
-<para>Made some improvements to bibliography formatting.
-</para>
-</listitem>
-<listitem>
-<para>Improved graphical formatting of admonitions.
-</para>
-</listitem>
-<listitem>
-<para>Added support for <sgmltag>entrytbl</sgmltag>.
-</para>
-</listitem>
-<listitem>
-<para>Support spanning index terms.
-</para>
-</listitem>
-<listitem>
-<para>Support <sgmltag>bibliosource</sgmltag>.
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.57.0</title>
-<itemizedlist>
-<listitem>
-<para>The 1.57.0 release wasn't documented here. Oops.
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
-<title>Release 1.56.0</title>
-<itemizedlist>
-<para>The 1.56.0 release fixes bugs.
-</para>
-<listitem>
-<para>Reworked chunking. <emphasis>This will break all existing customizations
-layers that change the chunking algorithm.</emphasis> If you're customizing chunking,
-look at the new <quote>content</quote> parameter that's passed to
-<literal>process-chunk-element</literal> and friends.
-</para>
-</listitem>
-<listitem>
-<para>Support continued and inherited numeration in <sgmltag>orderedlist</sgmltag>
-formatting for FOs.
-</para>
-</listitem>
-<listitem>
-<para>Added Thai localization.
-</para>
-</listitem>
-<listitem>
-<para>Tweaked stylesheet documentation stylesheets to link to TDG and
-the parameter references.
-</para>
-</listitem>
-<listitem>
-<para>Allow title on tables of contents ("Table of Contents") to be optional.
-Added new keyword to <parameter>generate.toc</parameter>.
-Support tables of contents on sections.
-</para>
-</listitem>
-<listitem>
-<para>Made separate parameters for table borders and table cell borders:
-<parameter>table.frame.border.color</parameter>,
-<parameter>table.frame.border.style</parameter>,
-<parameter>table.frame.border.thickness</parameter>,
-<parameter>table.cell.border.color</parameter>,
-<parameter>table.cell.border.style</parameter>, and
-<parameter>table.cell.border.thickness</parameter>.
-</para>
-</listitem>
-<listitem>
-<para>Suppress formatting of <quote>endofrange</quote> <sgmltag>indexterm</sgmltag>s.
-This is only half-right. They should generate a range, but I haven't figured out how
-to do that yet.
-</para>
-</listitem>
-<listitem>
-<para>Support <sgmltag>revdescription</sgmltag>. (Bug #582192)
-</para>
-</listitem>
-<listitem>
-<para>Added <parameter>default.float.class</parameter> and fixed figure
-floats. (Bug #497603)
-</para>
-</listitem>
-<listitem>
-<para>Fixed formatting of <sgmltag>sbr</sgmltag> in FOs.
-</para>
-</listitem>
-<listitem>
-<para>Added context to the <quote>missing template</quote> error message.
-</para>
-</listitem>
-<listitem>
-<para>Process <sgmltag>arg</sgmltag> correctly in a <sgmltag>group</sgmltag>.
-(Bug #605150)
-</para>
-</listitem>
-<listitem>
-<para>Removed 'keep-with-next' from <parameter>formal.title.properties</parameter>
-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.
-</para>
-</listitem>
-<listitem>
-<para>Wrap <quote>url()</quote> around external-destinations when appropriate.
-</para>
-</listitem>
-<listitem>
-<para>Fixed typo in compact list spacing. (Bug #615464)
-</para>
-</listitem>
-<listitem>
-<para>Removed spurious hash in anchor name. (Bug #617717)
-</para>
-</listitem>
-<listitem>
-<para>Address is now displayed verbatim on title pages. (Bug #618600)
-</para>
-</listitem>
-<listitem>
-<para>The <parameter>bridgehead.in.toc</parameter> parameter is now properly
-supported.
-</para>
-</listitem>
-<listitem>
-<para>Improved effectiveness of HTML cleanup by increasing the number
-of places where it is used. Improve use of HTML cleanup in XHTML stylesheets.
-</para>
-</listitem>
-<listitem>
-<para>Support table of contents for <sgmltag>appendix</sgmltag> in
-<sgmltag>article</sgmltag>. (Bug #596599)
-</para>
-</listitem>
-<listitem>
-<para>Don't duplicate footnotes in <sgmltag>bibliography</sgmltag>s and
-<sgmltag>glossary</sgmltag>s. (Bug #583282)
-</para>
-</listitem>
-<listitem>
-<para>Added <parameter>default.image.width</parameter>. (Bug #516859)
-</para>
-</listitem>
-<listitem>
-<para>Totally reworked <sgmltag>funcsynopsis</sgmltag> code; it now
-supports a 'tabular' presentation style for 'wide' prototypes; see
-<parameter>funcsynopsis.tabular.threshold</parameter>. (HTML only
-right now, I think, FO support, uh, real soon now.)
-</para>
-</listitem>
-<listitem>
-<para>Reworked support for difference marking; toned down the colors a bit
-and added a <quote>system.head.content</quote> template so that the diff CSS
-wasn't overriding <quote>user.head.content</quote>. (Bug #610660)
-</para>
-</listitem>
-<listitem>
-<para>Added call to the <quote>*.head.content</quote> elements when writing
-out long description chunks.
-</para>
-</listitem>
-<listitem>
-<para>Make sure <sgmltag>legalnotice</sgmltag> link is correct even when
-chunking to a different <parameter>base.dir</parameter>.
-</para>
-</listitem>
-<listitem>
-<para>Use CSS to set viewport characteristics if
-<parameter>css.decoration</parameter> is non-zero, use div instead of p for making
-graphic a block element; make figure <sgmltag>title</sgmltag>s the
-default alt
-text for images in a <sgmltag>figure</sgmltag>.</para>
-</listitem>
-<listitem>
-<para>Added space-after to <parameter>list.block.spacing</parameter>.
-</para>
-</listitem>
-<listitem>
-<para>Reworked section.level template to give <quote>correct</quote> answer
-instead of being off by one.
-</para>
-</listitem>
-<listitem>
-<para>When processing tables, use the <sgmltag class="attribute">tabstyle</sgmltag>
-attribute as the division class.
-</para>
-</listitem>
-<listitem>
-<para>Fixed bug in <filename>html2xhtml.xsl</filename> that was causing the
-XHTML chunker to output HTML instead of XHTML.
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<section>
- <title>Older releases</title>
- <para>To view the release notes for older releases, see <ulink
- url="http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml"/>. Be
- aware that there were no release notes for releases prior to the
- 1.50.0 release.</para>
-</section>
-<section id="dot0">
- <title>About dot-zero releases</title>
- <para>DocBook Project <quote>dot zero</quote> releases should be
- considered <emphasis>experimental</emphasis> and are always
- followed by stable <quote>dot one</quote> releases, usually within
- two or three weeks. Please help to ensure the stability of
- <quote>dot one</quote> releases by carefully testing each
- <quote>dot zero</quote> release and reporting back about any
- problems you find. </para>
- <para>It is not recommended that you use a <quote>dot zero</quote>
- release in a production system, or package it for an OS
- distro. Instead, you should wait for the <quote>dot one</quote>
- version.</para>
- </section>
-</article>
+++ /dev/null
-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