From: David H. <wa...@us...> - 2005-07-05 09:33:10
|
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/ |