README for the DocBook Stylesheets
$Id: README,v 1.6 2005/04/20 23:58:41 xmldoc Exp $

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

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

Manifest
--------

AUTHORS     contact information
BUGS        about known problems
COPYING     copyright information
INSTALL     installation instructions
README      this file
RELEASE*    per-release cumulative summaries of user-visible changes
TODO        about planned features not yet implemented
VERSION     the current version number (note that this is an XSL stylesheet,
            included by both fo/docbook.xsl and html/docbook.xsl)
NEWS        changes since the last public release (for cumulative lists of
            changes, see the ChangeLog files in each subdirectory)
common/     contains code common to both the HTML and FO stylesheets
doc/        documentation
docsrc/     documentation sources
eclipse/    stylesheet that produces Eclipse Help
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
manpages/   stylesheets for producing groff/nroff man pages
profiling/  stylesheets for profiling (omitting/including conditional text) 
template/   contains templates for building stylesheet customization layers
xhtml/      stylesheets that produce XHTML

Changes
-------

See the ChangeLog in each subdirectory for cumulative lists of all changes.

See the NEWS file for changes made since the previous release.

See the RELEASE-NOTES.html or RELEASE-NOTES.txt file for per-release
cumulative summaries of significant user-visible changes.

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

See the INSTALL file for information about installing this release.

Use
---

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

  html/docbook.xsl      - for HTML (as a single file)
  html/chunk.xsl        - for HTML (chunked into multiple files)
  html/onechunk.xsl     - for HTML (chunked output in single file)
  xhtml/                - for XHTML versions above the above
  fo/docbook.xsl        - for XSL FO
  manpages/docbook.xsl  - for groff/nroff man pages
  eclipse/eclipse.xsl   - for Eclipse Help
  htmlhelp/htmlhelp.xsl - for HTML Help
  javahelp/javahelp.xsl - for JavaHelp
