Re: Automatic widget documentation

Charles Goodwin <[email protected]> writes:
> XSL might work for us here if we can get it to hit/analyse comments (for
> documenting functions).

Oh please no.

I'm okay with defining our own tags for documentation, just keep XSL
out of the picture.

I'm actually also going to reverse my former position; I think javadoc
style comments are okay for function-specific or variable-specific
comments.  Just as long as you support

   /// this gets attached to foo
   var foo;

Note the triple-slash.


> Perhaps a combination of XSL for the XML and another form of automatic
> documentation would be a funky combination.

This can be done without XSL! ;)

  - a