On 1/3/06, Bob Harner <[EMAIL PROTECTED]> wrote: > As for comments within files, it might be worthwhile to more carefully > consider how this is structured, rather than just putting plain text > inside of comment tags. It would be nice to have the internal > documentation in these files be extractable (someday) by a program, in > the same way that javadoc documentation is easily extractable from > java source code. See > http://www.codeproject.com/soap/xsltdocumentor.asp an example of such > a program for XSLT files in particular. Does anyone else have any > suggestions in this area? We will need a syntax for documenting xslt > and xmap files especially.
You inspired me. http://solprovider.com/lenya/xsltdoc Is that a useful start? It does not expect any special tags, but we could parse comments to decide how or if to display them. Some of my test files have code commented out, and having the obsolete code in the documentation is annoying. solprovider --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
