[as2api-dev] Re: [Asunit-users] Great tool, but where's the documentation?

[David Holroyd]

On Mon, Jul 04, 2005 at 10:44:30PM -0400, Kristopher Schultz wrote:
> Also, I've decided to use Dave's as2api utility as my reference doc
> generator when proofing my doc comments. I've chosen as2api because a)
> I'd like to support Dave's efforts (thanks, Dave!), b) using as2api
> should help ensure that the doc comment formatting will parse properly
> in any doc gen tool that supports javadoc style tags, and c) it's
> free.

Cool!  If there's anything I can do to help, just let me know (maybe on
as2api-dev -- to keep off-topic discussion away from the asunit list).


> There are some downsides, however. From what I can tell, as2api can
> not currently generate XHTML-compliant markup (and in fact, the markup
> required to get the doc comments to display properly will likely have
> to change if as2api ever does become XHTML-compliant),

I put a bit of effort into making output from the as2api 0.3 release
validate against the XHTML DTDs.  Are you using an older version, or did
I miss some bugs?


> and it doesn't support alternate output formats - especially Flash
> Help and XML.

I spend next-to-no time using the MM Flash IDE, so I'm more motivated to
get the HTML output working really well, for the moment.  [ I'll accept
patches ;) ]


dave

-- 
http://david.holroyd.me.uk/