1) Для документации существует соответствующий формат:
Код AS3:
/** Документация */
public function myFunc () {};
2) Подробное описание ->
тут.
3) Графическая оболочка для ASDOC ->
тут.
4) Вариант компиляции ANT-ом ->
тут и
тут.
О великий и могучий
google.