ActionScript的API文档生成工具ASDoc

运用asdoc工具
原文地址: http://livedocs.adobe.com/flex/3/html/asdoc_9.html
译者注：
asdoc是adobe官方提供的actionscript的api文档生成工具，现在已经集成在flexbuilder3中
打开asdoc工具的方法：
1.安装flexbuilder3后，
打开 开始—>程序—>adobe—>adobe flex 3 sdk command prompt
2.此时会进入cmd命令行界面，用cd命令进入你的工程目录下
例如我的工程目录是e:\flexwork
当前是cmd指向在c:\program files\adobe\flexbuilder3\
3.首先输入 e:进入e:\
然后 输入 cd flexwork
屏幕显示e:\flexwork\> 后即可使用asdoc命令编译api文档了
编译后的asdoc文档会在e:\flexwork\路径下输出一个asdoc-output文件夹，运行里面的index.html就是api文档主页
你可以使用以下的asdoc命令参数来制定类文件列表
doc-classes doc-sourcess doc-namespaces
doc-classes和doc-namespaces要求用source-path指定类文件文件所在的根目录
如下是一个最基本的列子，用doc-classes参数指定类文件列表：
asdoc –source-path . –doc-classes comps.craphingwidget comps.graphingwidgettwo
这个例子中，类文件必须是comps\graphingwidget.as和comps\graphingwidgettwo.as,并且comps必须是位于运行asdoc命令所在位置下的一个子文件夹。doc-classes的参数中用‘.’对应类所在的包(package)名
译者注：如果类文件就在当前目录下，source-pathh参数后面的内容需要填写’.’
如果类文件没有在当前目录下，可以用source-path参数指定该目录。
下面的例子，如果两个类文件在c:\flex\class_dir\comps下，可以像这样使用asdoc命令：
asdoc –source-path c:\flex\class_dir\comps –doc-classes comps.craphingwidget comps.graphingwidgettwo
如果你的程序里引用了包含有swc文件的库。
在下例中，可以使用 –library-path参数指定要包含的swc文件：
asdoc –source-path . –doc-classes mycomponents.bluebutton –library-path c:\mylibs
用 doc-sources参数可以指定源文件夹。通过该参数，asdoc会递归搜寻目录。
下面的命令会生成当前目录及其子目录下所有的类：
asdoc –source-path . –doc-sources
用 doc-namespaces参数可以指定要输出的命名空间。
下面的命令会把core framework下的所有类文件输出成文档：
asdoc -source-path frameworks -namespace http://framework frameworks/core-framework-manifest.xml -doc-namespaces http://framework
排除类文件
用doc-classes, doc-sources和 doc-namespaces命令输出所有的类文件时，
会有以下三点例外：
用exclude-classes参数指定的类不会输出 类中包含了@private标签的不会被输出 swc中的类，不会被输出 以下的例子中，会输出当前目录及其子目录下所有类文件，除了comps\pagewidget 和 comps\screenwidget.as：
asdoc -source-path . -doc-sources . -exclude-classes comps.pagewidget comps.screenwidget
注意：
这些被排除的类，仍然会同其他类一样被编译，只是内容不会被输出
如果将exclude-dependecies参数设为true，当编译类时所依赖的相关类不会被输出。
该参数默认值是false，意味着所有与指定类相关联的类都会被正常输出成文档。
例如：你用doc-classes指定了类a,如果类a中 import了类b，那么类a和类b都会被输出。