usr/lib/sgml/stylesheets/nwalsh-modular/doc/ contains some really useful
documentation, but it's hard (as in "wack your head against the wall for a
while") to find because it's not in /usr/doc.

I'd probably be a good idea to put the doc in an nwalsh-modular
sub-directory, to make it more clear that it just applies to the
nwalsh-modular style sheets.

(Hate to do this to your bug tracking system)  Also...

/usr/lib/sgml/stylesheets/dbtohtml.dsl dosen't work (for me anyhow, with
jade), although it looks like a good example and should probably be kept
around.  (I think it needs additional <> markup above and below the scheme
code, sorta like this:

----------<snip>-----------

4.4. Customizing the Stylesheets

The best way to customize the stylesheets is to write your own "driver"
file; this is a stylesheet that contains your local modifications and then
includes the
appropriate stylesheet from the standard distribution by reference. This
allows you to make local changes and extensions without modifying the
distributed files,
which makes upgrading to the next release much simpler.

4.4.1. Writing Your Own Driver

A basic driver file looks like this:

<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY dbstyle PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print
Stylesheet//EN" CDATA DSSSL>
]>

<style-sheet>
<style-specification use="docbook">
<style-specification-body>

;; your changes go here...

</style-specification-body>
</style-specification>
<external-specification id="docbook" document="dbstyle">
</style-sheet>

----------<snip>-----------

but idunnknow.  Maybe changing it to work with jade would completely break
something else.)