RE: [relax-ng] Annotations in the non-XML syntax

Mike,
   Your stylesheet could peel off XHTML and simply <xsl:copy/> it to an output html file.
Or, perhaps, the TC could offer a recommended use of the ibtwsh vocabulary for documentation.  
Using John's ibtwsh.rng file in conjunction with the rng4rng schema, you could validate
a RELAX NG schema file with embedded documentation, then create custom stylesheets around the 
combination of the two.

   and on a related topic...

   Attached is a stylesheet that pretty prints a RELAX NG file. It doesn't do
anything with foreign elements yet.   Also attached is a 'pretty printed' version of
the rng4rng schema document, after running it thru this stylesheet.  

   With printout this 'pretty', who needs documentation? ;)

Enjoy! tom


 

-----Original Message-----
From: Michael Fitzgerald [mailto:]
Sent: Thursday, March 21, 2002 6:41 PM
To: James Clark; RELAX NG List
Subject: RE: [relax-ng] Annotations in the non-XML syntax


I think Javadoc encourages coders to document their code better because it
is easy to make pretty HTML documentation.

We could do something similar by offering (at least informally) some
pretty-print stylesheets for pulling a:documentation, DocBook, or XHTML
annotations from RELAX NG schema.

The attached stylesheet is a meager beginning (revised from my last post on
this). I am happy to spend some more time on this, but I need critical
comments.

Mike

-----Original Message-----
From: James Clark [mailto:]
Sent: Wednesday, March 20, 2002 5:13 AM
To: John Cowan; Michael Fitzgerald
Cc: RELAX NG List
Subject: Re: [relax-ng] Annotations in the non-XML syntax



> I'd rather map the # comments into <!-- ... --> comments

I will try and do this, though it's not altogether straightforward. However,
I feel a little bit uneasy in that it will tend to encourage people to put
documentation in comments rather than annotations.  I would like to find
some way for the non-XML syntax to make it as easy to put documentation in
annotations as in comments.

James