RE: Self documentation, my crude stab in that direction

["Pawson, David" <DPawson at rnib dot org dot uk>]

>[Apologies for coming to this discussion a bit late. My two cents
>follows.]

<grin>You don't do things in 2c worth</grin>

> One of my goals for my
>XSL DocBook Stylesheets is that they be less poorly documented. To
>that end, I want to combine documentation with the stylesheets in a
>way roughly analagous to the JavaDoc system that seems to work fairly
>well.


>
>For each
>template/variable/etc., I have an element in the doc: namespace that
>contains documentation for it. My goal (as yet only partially
>achieved) is to write stylesheets that build (reference/API)
>documentation from this system. (This system isn't meant to address
>tutorial and end-user documentation.)

Stepping back a little Norm.
Just checking understanding.
From the example I think you want to produce docbook xml
(as documentation) from the docbook xsl stylesheets.
Then to (presumably) use your docbook stylesheets again
to format that into pdf/html?

Is that your objective?
========

One for Rick J here. How to spot that last weekend, when
you were tired/(other) you forgot to add the doc namespaced
entry for variable xyz? Is Schematron capable of this?

Regards, DaveP


 XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list