[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] Re: XSL - Documentation
Am 13.05.2009 um 15:51 schrieb Tony Graham:
With GTK-Doc, structured comments in C code get turned into HTML documentation. While following this thread I learned a lot from the discussions. A documentation framework that (it seems) wasn't mentioned is <http://doxsl.sourceforge.net/ >. I found a bookmark but have not tested it. It seems to use custom elements and comes with premade stylesheets to produce output. For my projects I am looking at structured comments together with some ;lightweight markup language+ <http://en.wikipedia.org/wiki/Lightweight_markup_language >. Mainly because most projects also include XML files, and I can add comments even to output XML files without any need to modify the DTD/ XSD. My question: Are there any standards for marking a "structured" XML comment? I am not talking about the comments content, just how to easily differentiate a structured comment from a simple comment. My first ideas would be: <!--/** ... --> <!--// ... --> <!--- ... ---> <!--[ ... ]--> - Michael -- _______________________________________________________________ Michael M|ller-Hillebrand: Dokumentation Technology Adobe Certified Expert, FrameMaker Consulting and Training, FrameScript, XML/XSL, Unicode Blog [de]: http://cap-studio.de/
|
PURCHASE STYLUS STUDIO ONLINE TODAY!Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced! Download The World's Best XML IDE!Accelerate XML development with our award-winning XML IDE - Download a free trial today! Subscribe in XML format
|