[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Subject: 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:mike@wyeast.net] 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:jjc@jclark.com] 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
Attachment:
prettyPrintRNG.xsl
Description: prettyPrintRNG.xsl
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Powered by eList eXpress LLC