I was searching for a valid AS documentation tool…
I have tested the AS2Doc trial but it doesn’t parse correctly my classes.
Also ZenDoc seems to be a valid alternative, also because it’s written in PHP, but it skip all the uncommented methods 🙁
NaturalDocs probably is the best choice, for me, but it doesn’t support standard javadoc comments
Acid gives me python errors while parsing the packages and the python code is quite unreadable.
BLDoc is really promising, but it’s still in beta
Probably the best program I found is as2api, which creates a standard javadoc html output. The only thing is that it doesn’t seem to have an option to allow documentation for private methods
Did you have experience with some of these tools, or someone else I didn’t tested?
Which one do you currently use?
bldoc
BLDoc 1.0 Public Beta Available
Chafic Kazoun from rewindfile.com has released late yesterday the first public beta of BLDoc.
What is BLDoc?
“BLDoc is an ActionScript 2.0 source code documentation tool designed to require minimal commenting to produce complete documentation. BLDoc supports multiple output styles (including the ability to create your own), parsing of AS 2.0 source, MetaData tags, and JavaDoc style comments.”
You can also use BLDoc with SE|PY in order to create autmatically Javadoc style documentation. Latest version of sepy has a new feature which with a simple mouse click will create for you javadoc comment for any method of your source code (thanks to a suggestion of Colin Moock).
Then BLDoc processes a series of customizable commands to run many XSLT transformations on the intermediate file. And it will come in 2 different editions: community edition and professional edition.
Find out more here: http://www.blinex.com/products/bldoc/