[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: XSL - Documentation

Subject: Re: XSL - Documentation
From: Michael Müller-Hillebrand <mmh@xxxxxxxxxxxxx>
Date: Fri, 15 May 2009 10:12:08 +0200
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/

Current Thread

PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.