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

diff --git a/xsl/BUGS b/xsl/BUGS
index 5723ffd37380bbb74f42c67f9d6fe29375e5c605..6ca80f1f66a87d05228f28707c51423e67a714b9 100644 (file)
--- a/xsl/BUGS
+++ b/xsl/BUGS
@@ -1,6 +1,5 @@
-The fo stylesheet is probably not in perfect sync with the html stylesheet
+For information about open DocBook XSL stylesheets bugs, see the
+following:
 
-Using Equations w/o titles results in incorrectly numbered
-  equations with titles.  Use InformalEquation instead.
-
-The 'char' alignment in tables is not supported
+  http://sourceforge.net/tracker/?atid=373747&group_id=21935&func=browse
+  http://sourceforge.net/tracker/?atid=516914&group_id=21935&func=browse

diff --git a/xsl/README b/xsl/README
index a7190b3881617f6a3872a406da3d2acce7303853..f54aa34d1b43344c709a28f3a8d3dd552d4b0a9b 100644 (file)
--- a/xsl/README
+++ b/xsl/README
@@ -1,51 +1,57 @@
 README for the DocBook Stylesheets
+$Id$
 
-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.
+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
 --------
 
+BUGS        about known problems
+INSTALL     executable script for generating a catalog.xml file
 README      this file
-TODO        planned features not yet implemented (may be incomplete :-)
-BUGS        known problems (may also be incomplete :-)
+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)
-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
+WhatsNew    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 
+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 directory for additional information
-about the specific changes.
+See the ChangeLog in each subdirectory for cumulative lists of all changes.
 
 See WhatsNew for changes since the last release.
 
+See the RELEASE-NOTES.html or RELEASE-NOTES.txt file for per-release
+cumulative summaries of significant user-visible changes.
+
 Installation
 ------------
 
-Unpack the distribution somewhere.
+Unpack the distribution somewhere. Run the INSTALL script and follow the
+instructions it generates.
 
 Use
 ---
@@ -53,10 +59,13 @@ 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)
+  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
 

diff --git a/xsl/TODO b/xsl/TODO
index 526aca8bf60ca031896799dd07c5b93158420b25..404c75431e4e424363c6879dbe866ce9e65dfa64 100644 (file)
--- a/xsl/TODO
+++ b/xsl/TODO
@@ -1,4 +1,5 @@
-Documentation
-Continued lists
-Bibliography support needs improvement
+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