ASDoc是Adobe官方免費並且 open source的工具，目的是用來替 source code生成 class reference doc，官方自己的 livedocs也都是用 ASDoc生成的。不過由於ASDoc是一個command line工具，也就是說它沒有GUI介面，所以搭配 FlashDevelop內建的GUI工具來輸出文件會方便許多。

取得 FlashDevelop
原來我一直在用的FD在 FlashDevelop 3.0.0 beta8 以上的版本開始，就內建一個支援ASDoc的簡易GUI工具叫做Actionscript Documentation Generator，它可以把每次編譯的class路徑、編譯參數、輸出位置等等資訊存成一個*.docproj檔，隨時可以叫出來修改。

取得 ASDoc
從Flex SDK 2.0以後，ASDoc就預設附加在bin資料夾裡面了，所以如果已經安裝 Flex SDK或 Flex Builder的話就只需要在FlashDevelop只要設置路徑就可以了。需要者可以在此 下載 Flex SDK，基本上一定還是要有整包SDK，因為ASDoc需要SDK裡的其他工具作編譯和錯誤檢查。

開始使用ASDoc
上述的工具就照預設的方式安裝就可以了，然後找到 FD -> Tools -> Flash Tools-> Documentation Generator 。首先開啟setting標籤設定你的ASDoc路徑，像我這樣指到ASDoc location，也就是Flex sdk的bin資料夾。

接著回到project標籤。Page title填入整份文件的名稱。exclude classes可以用來排除你不想編入文件的單一class，例如：填入 "com.ClassA com.ClassB" 排除com package下的ClassA和ClassB兩個class，中間用空格區別，但不能用"com.*"同時排除底下的兩個class。Output directory 是你想輸出Doc的位置。

在來就是卡了我很久的地方xd，Classpaths 要填入你所使用到的第三方package，這個欄位的設定與 project 的classpath設定是沒有直接關聯的，ASDoc編譯的時候，他還是會再去呼叫sdk的編譯器，再重新檢查一次你的code有沒有錯誤，如果有錯誤輸出就失敗，並且在Output標籤裡面列出錯誤訊息，所以你有使用到任何第三方的package的話，這邊就要再填一次。

Extra option 可以選擇性的填入編譯的參數，-source-path 是source code的位置，-doc-classes 是要編譯的單一Class，請在裡面填入標準的package路徑，例如"com.myname.ClassA com.myname.ClassB"，同樣用空格作區隔，如果想要編的class是某路徑的全部class可以填"-doc-sources ."，除了ASDoc專用的參數外，也可以傳遞as3編譯器用的參數進去，例如"-strict=false"。Compiler請選ASDOC(AS3)。更多的編譯參數可以參考官方文件 Using ASDoc 。

然後你就得到一個漂漂亮亮的class參考文件了。

排除Package
再來是卡住我很久的第二個地方，如果不想把第三方的package一起編進reference(不想編進去的需求應該是比較大的)，比如我不想把非自行開發的Tweener也編進去，那就加入另一個參數"-exclude-dependencies=true"，並且把設定好的Classpaths全部移除掉，否則會發生錯誤。

以上的方法我用在輸出用到沒很複雜的第三方的lib時都沒有問題，但因為asdoc還會去檢查code有沒有錯誤，就算用了strict=false，還是會被寫得不夠嚴謹的code給擋住，比如函式的回傳型別不能沒寫，但竟然as3corelib裡面有很多這種狀況，不太可能遇到一個改一個；再來比如把script用外部連接的方式嵌到mxml裡也會被視為是bug。所以還是有狀況導致我還沒有能夠真正替我的code成功輸出文件，要怎麼辦還要再研究研究。

大致上就是以上這樣，以上除了介面的操作，其他應該都跟直接使用command line模式是一樣的。問題都搞定的話再來就是要了解怎麼去替程式作註解了。

文件的註解方式請參考官方的文件：Creating ASDoc comments

特別謝謝Ticore大的幫忙。