Description

ASDocGen is a generic ActionScript documentation generator user interface for AS2API and ASDoc. It makes it easy to generate documentation from ActionScript code and you can save the documentation parameters as a project. Both tools use a JavaDoc type documentation syntax so it's easy to start producing high quality documentation with ASDocGen.

Usage

ASDoc has only one type of project (*.docproj) and it parses the arguments based on the compiler. The only difference between the two is the usage of the "Packages" / "Exclude classes" and the "Classpaths" fields. AS2API looks for the classpaths for the specified packages to be documented. You can list packages indivially or use a wildcard "*". (ie. com.company.package or com.company.*). The list should be space separated. ASDoc documents directly the specified classpaths and you can use the "Exclude classes" field to exclude classes from being documented. You can also import settings from AS2 Project or AS3 Project using "Import Project".

Explanation of arguments:

Settings

In the settings you can define the location of the compilers. AS2API is already set but you can change it if you want to use a custom version. ASDoc compiler needs to be defined so that you can use it. It is part of the free Flex SDK. You can use the "Copy compiler related template files" setting to use custom files (ie. css styles or other files) to be copied to the output directory. You need to place the files to ASDocGen/Files directory and each filename should start with a compiler name and a slash (ie. as2api-styles.css). This tells to the ASDocGen which files are for which compiler. The files will be copied everytime you compile the documentation.

Explanation of settings:

Advanced

Detailed help, syntax and command line argument lists can be found from the these locations: