Если с Java в этом деле всё обстоит неплохо, с ActionScript 3.0 есть трудности: asdoc перед проверкой осуществляет синтаксический анализ кода и если находит ошибки, документации не генерирует. На практике, это означает, что при генерации кода нужно прописывать пути ко всем либам. Для флекса это ещё туда – сюда, но с флешом дело плохо. Во первых, если я хочу создать мувиклип, не создавая ассоциированный с ним файл, сделать это не удастся. Во вторых есть либы, которые вставляются в flash CS как плагин. Короче, без танцев с бубном сгенерировать не удастся.
Да и вообще, сам подход неприличен: я должен сам указывать инструменту, что мне делать, а не он мне указывать, как быть. Вот не хочу я ещё раз проверять код - я уже проверил его другими средствами, уже скомпилировал. Зачем мне ещё какой - то asdoc?
Он написан на перле, в качестве интерпретатора для винды предлагается скачать Active Perl. Вот его сайт: http://www.activestate.com/activeperl
Далее, качаем RealDocs и распаковываем его. Идем в папку, куда разархивировали RealDocs и правим предпоследнюю строчку так, чтобы получилось нечто вроде.
Далее, создаем скрипт для генерации, примерно такой
d:\install_windows\NaturalDocs\NaturalDocs -i d:\projects\hello -o html d:\outputdocs -p d:\naturaldocsproject
-o Тип документа, который будем генерировать и путь к папке, куда складывать доки
- p путь к файлу проекта, куда складывают логи
Сообщения
