обо всем по-немногу...
ASDoc Comment Injector
Запись от cleptoman размещена 08.02.2011 в 23:30
наткнулся в сети на достаточно старую тему (потому для многоих, не исключено, это будет инфой не первой, скажем так, свежести)
Commentor
что делает - лопатит все классы по указанной директории -input
добавляет "рыбу" ASDoc коментариев к классам, методам и свойствам
и генерирует новые классы в -output. (хотя есть параметр перезаписи исходных классов, но для тестов чот я побоялся ее поюзать)
в общем-то, вся нужная ознакомительная информация есть в пруф-линке. расскажу немного о своих манипуляциях с этой програмулиной:
1 - распаковал.
2 - на базе любезной предоставленных BATников состряпал свой
3 - закинул его в темплейт проекта FD (pure AS3)
4 - создал проект. увидел свой батничек
5 - запустил батник
результатом, в общем доволен: есть готовая "рыба", по которой можно уже облагораживать код своими коментариями. готовить ASDoc.
что не понравилось: не коментит метатеги. не коментит дефолтные значения в аргументах методов.
ну это все навскидку.
тема - не исключено, что боян. Но, может, кому и пригодится.
прилагаю свой батник (некоторые аргументы из хелпа просто заменил обычной текстовкой в -info)
Код:
E:\commentor\commentor -info "@see http://cleptoman.free-lance.ru" -info "@author Aleksey Kutov aka cleptoman" -info "@langversion ActionScript 3.0" -input src\ -output asdoc_comm_injected\ pause
Всего комментариев 11
Комментарии
09.02.2011 19:16 | |
ага, спасибо.
|
10.02.2011 13:35 | |
Полезна и статейка и дополнение про /**. Только с аксессорами не работает, поведение такое же как и Empty комментарий. Так и должно быть?
|
10.02.2011 13:54 | |
Да. Это же аксессор.
|
10.02.2011 14:41 | |
Можно добавить комменты к аксессорам через Tools -> ApplicationFiles -> Data -> ASCompleteion -> Generator.txt
|
10.02.2011 15:02 | |
вроде как геттер описывается, но не понятно как и что описывать, если у нас только сеттер, например)
|
10.02.2011 15:08 | |
Там не важно, что описывается, геттер или сеттер. Описание одно на всех. Просто будет read-write, only read или only write.
|
10.02.2011 16:42 | |
Цитата:
Это странная ситуация - зачем тогда вообще аксессоры?
|
10.02.2011 23:54 | |
Последние записи от cleptoman
- Starling Builder. Дождались? (28.10.2015)
- Starling. Particles. StarMaker... (05.12.2012)
- FLVEncoder (02.08.2011)
- UnsecurityDisplayLoader - обертка для несекьюрной загрузки дисплей контента (12.02.2011)
- ASDoc Comment Injector (08.02.2011)