Быстрый старт с ASDoc во Flash Builder 4

Пока Флекс не собирается исчезать, этото совет может кому-то пригодиться.

Работа с ASDoc во Flex SDK обстоит неказуально, разобраться без посторонней помощи сложно, даже очень. Как-то я потерял на этом день и теперь знаю, как этого избежать. 

Ant ASDoc Task

Flex Ant ASDoc Task — это утилита-обертка вокруг ASDoc tool, позволюящая вынести опции сборки в файл build.xml, а затем собрать документацию через ASDoc с Apache Ant. Для быстрого старта с Ant ASDoc Task изучите и переделайте уже работающие примеры. Например, сборку документации к классам, идущим в составе Flex SDK.

Начните с файла "c:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.X.X\asdoc\build.xml". Это готовый конфиг для сборки. В любом Flex SDK нужный билд-файл находится по относительному адресу "[FLEX_SDK_DIR]\asdoc\build.xml". 

Данный конфиг можно легко переделать под свой проект. Это легче, чем начинать с нуля, вы быстро поймете, что в нем вам нужно, а что — нет.

Полезная ссылка: http://racer242.blogspot.com/2008/01/asdoc-as3.html