docbook output is now generated into a singlefile called "doctrine.html", and a whole set of files in the "html" folder.

manual/docbook/Makefile

@@ -1,5 +1,7 @@
 XSLSTYLE=doctrine.xsl
+XSLSTYLE_CHUNKED=doctrine-chunked.xsl
 %.html:  %.xml
-	xsltproc  --output  $@  $(XSLSTYLE)  $<
+	xsltproc  --output $@ $(XSLSTYLE)  $<
+	xsltproc  --stringparam base.dir html/ $(XSLSTYLE_CHUNKED)  $<
 
 html:  doctrine.html

manual/docbook/README

@@ -11,3 +11,8 @@ Pleaes use xmllint to validate your changes BEFORE committing.
 Please follow the intenting format used in the file.
 *2 SPACES* for indenting.
 That's SPACES not TABS :)
+
+For documentation about docbook XSL, visit:
+http://www.sagehill.net/docbookxsl/index.html
+
+For information about docbook itself, google - there's LOTS of sites.

manual/docbook/doctrine-chunked.xsl

@@ -0,0 +1,5 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+<xsl:import href="/usr/share/sgml/docbook/xsl-stylesheets-1.70.1/xhtml/chunk.xsl"/>
+<xsl:param name="html.stylesheet" select="'doctrine.css'"/>
+</xsl:stylesheet>

manual/docbook/doctrine.xml

@@ -88,6 +88,8 @@
           list is quite high traffic, as every commit to the repository results
           in an email containing the changelog entry and diffs of the changed
           files.
+          To subscribe to this list, send a blank email to
+          <email>doctrine-svn+subscribe@lists.pengus.net</email>
         </para>
       </sect2>
       <sect2 id="community-irc">