documentation/xsl

README for the DocBook Stylesheets

These are XSL stylesheets for the DocBook XML DTD. (They would
also work for the DocBook DTD, modulo certain namecase problems
and the fact that there aren't (yet) any XSL implementations
that work with SGML source documents.)

As of version 1.0, most of the elements in DocBook are handled
in some way or another, usually reasonably, but there's still
lots of work to be done.

For more information, see http://docbook.sourceforge.net/

Manifest
--------

README      this file
TODO        planned features not yet implemented (may be incomplete :-)
BUGS        known problems (may also be incomplete :-)
VERSION     the current version number (note that this is an XSL stylesheet,
            included by both fo/docbook.xsl and html/docbook.xsl)
WhatsNew    changes since the last public release (for a complete list
            of changes, see the ChangeLog file(s))
common/	    contains code common to both stylesheets
doc/        documentation
docsrc/     documentation sources
extensions/ Java extensions
fo/         stylesheets that produce XSL FO
html/	    stylesheets that produce HTML
htmlhelp/   stylesheets that produce HTML Help 
images/     images
javahelp/   stylesheets that produce Java Help
lib/        contains schema-independent functions
template/   contains templates for building stylesheet customization layers
xhtml/      stylesheets that produce XHTML

Changes
-------

See the ChangeLog in each directory for additional information
about the specific changes.

See WhatsNew for changes since the last release.

Installation
------------

Unpack the distribution somewhere.

Use
---

Process your DocBook documents with one of the following stylesheets
using your favorite XSLT processor:

  xhtml/docbook.xsl     - for XHTML
  html/docbook.xsl      - for HTML (as a single file)
  html/chunk.xsl        - for HTML (multiple files)
  fo/docbook.xsl        - for XSL FO
  htmlhelp/htmlhelp.xsl - for HTML Help
  javahelp/javahelp.xsl - for JavaHelp

Copyright
---------

Copyright (C) 1999, 2000, 2001 Norman Walsh

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the ``Software''), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

Except as contained in this notice, the names of individuals
credited with contribution to this software shall not be used in
advertising or otherwise to promote the sale, use or other
dealings in this Software without prior written authorization
from the individuals in question.

Any stylesheet derived from this Software that is publically
distributed will be identified with a different name and the
version strings in any derived Software will be changed so that
no possibility of confusion between the derived package and this
Software will exist.

Warranty
--------

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT.  IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER
CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

Contacting the Author
---------------------

These stylesheets are maintained by Norman Walsh, <ndw@nwalsh.com>.