diper (19.01.2013 03:12 - 03:32, просмотров: 106) ответил AVF на открыл для себя doxygen :) кто-нибудь использует? есть альтернативы?
Альтернативы по ссылке http://en.wikipedia.org/wiki/Comparison_of_documentation_generators
Если пользоваться всеми фичами - загрязнение кода.
Практика использования свелась к шапочками к файлам/классам/методам/функциям и описание свойств классов/структур и глобальных и static переменных.
Полезно для документирования API.
Бесполезно для понимания "как оно работает", лучше использовать правильные редакторы.
Если посмотреть Standard Peripheral Library то видно как он засран всякими defgroup. Документация выходит красивая а код нечитабельный. Надо искать баланс из расчета того кто потом это будет ковырять и с какой целью.