"Joern" == Joern Nettingsmeier
<nettings@xxxxxxxxxxxxxxxxxxxxxx>  writes:

Joern> as to re-using an existing grammer as opposed to making up Joern> one on-the-fly, i would also be interested in Joern>
recommendations from list members.

I would say it depends whether or not a particular grammar is sufficient for your purposes.

Joern> is there something Joern> similar to javadoc that can extract
documentation from xml Joern> files?

Yes. It's called ...

XSLT :-)

let me rephrase: is there a generally agreed upon, standardized way to
use xml elements from some namespace for systematic commenting that will
allow the automated extraction of documentation, similar to javadoc,
that *somebody else has already written*? :-D

At 2006-03-05 11:53 +0100, Jesper Tverskov wrote:

examples of how to annotate an XSLT stylesheet? ... In XSLT at
top-level we can have any additional markup of our own. Would it be
a good idea simply to use xs:annotation, etc., also in XSLT stylesheets? Or should each one of us invent our own markup for
this important task?

If you go to the "Free resources" section of our web site linked from
 our trailer below, you will find under "XSLT Resources" the XSLStyle
 documentation environment for XSLT stylesheets.

--
jvrn nettingsmeier

home://germany/45128 essen/lortzingstr. 11/
http://spunk.dnsalias.org
phone://+49/201/491621

if you are a free (as in "free speech") software developer
and you happen to be travelling near my home, drop me a line
and come round for a free (as in "free beer") beer. :-D