I'm successfully using DocBook XML and the modular XSL stylesheets to generate the documentation for my open-source project, Tapestry. I generate chunked and single-page HTML.
I currently use Ant to do the build and Saxon to do the transformations. I have some clever Ant tricks for building the final documents.
In the future, I want to generate PDF but FOP doesn't seem up to the task yet.
If your ant tricks are docbook related, would you share them please? DaveP.
You can pull the tapestry source from sourceforge (using cvs) and build the docs yourself using ant. Works out of the box, I think. I found it very useful for establishing an ant/docbook setup. LukeT.