Added some Notes section with info contributed by Barry Rountree.

diff --git a/xsl/manpages/README b/xsl/manpages/README
index 36368cdceaf8673c60e944daebc2ae5241011c2a..9acd516c2f8b80c648fa368d539530d5a7c75b2e 100644 (file)
--- a/xsl/manpages/README
+++ b/xsl/manpages/README
@@ -1,3 +1,67 @@
+$Id$
+
+-----------------------------------------------------------------
+Notes
+-----------------------------------------------------------------
+
+Here are some minimal details (contributed by Barry Rountree)
+about the behavior of the manpages stylesheets.
+
+  The first <refname> found is used to create the
+  file name of the man page.
+
+  The contents of <refentrytitle> are converted to
+  ALL CAPS and used, with <manvolnum>, to decorate the
+  bottom right and top corners of the page.
+
+  Any <indexterm> is not used in man-page output.
+
+  In order to document two or more items using the
+  same page, add additional refnames to <refnamediv>.
+  Each addtiona. refname will generate a small file
+  that points to (via the magic of *roff)
+
+    man[manvolnum]/[primaryRefname].gz
+
+More detailed how-to information about processing DocBook XML
+documents for man-page output will be available in the future.
+Somewhere. Written by someone...
+
+-----------------------------------------------------------------
+A short history of the DocBook manpages stylesheets
+-----------------------------------------------------------------
+
+October 2001 - September 2002: "The Silver Age"
+  Martijn van Beers <lotr@users.sourceforge.net> contributes XSL
+  stylesheets[1] for converting DocBook documents to *roff man pages,
+  and maintains them in the [cvs]/docbook/contrib/xsl/db2man area
+  of the project source-code repository, with frequent application
+  of patches from Tim Waugh <twaugh@users.sourceforge.net>.
+
+  [1] http://sourceforge.net/tracker/download.php?group_id=21935&atid=373749&file_id=11659&aid=468779
+      http://docbook.sourceforge.net/archive/db2man.tar.gz
+
+September 2002 - March 2003: "The Joe Orton Era"
+  The man-pages stylesheets are moved to [cvs]/docbook/xsl/manpages
+  and become a standard part of all subsequent DocBook XSL
+  Stylesheets releases. Joe Orton <jorton@users.sourceforge.net>
+  takes over manpages maintenance; more patches from Tim Waugh.
+
+March 2003 - May 2005: "Tim Waugh At the Helm"
+  Tim Waugh, eventually realizing that the possibility exists to
+  commit changes to to a source-code repository *directly*, joins
+  the project and takes over manpages maintenance, making a lot of
+  fixes and refinements.
+
+May 2005 - present: "Journey Into Mystery"
+  A sense of apprehension and uncertainty sets in as the
+  least-skilled an most frequently inebriated member of the
+  project takes over manpages maintenance.
+
+-----------------------------------------------------------------
+Original circa 2001 README contributed by Martijn van Beers
+-----------------------------------------------------------------
+
 README for db2man by Martijn van Beers (lotr@users.sourceforge.net)
 
 I've been working on some stylesheets to convert <refentry>s to man
@@ -7,4 +71,3 @@ docbook-xsl package.
 See also:
 
   http://sourceforge.net/tracker/index.php?func=detail&aid=468779&group_id=21935&atid=373749
-