GNU autoconf, опции документа с использованием doxygen? - PullRequest
0 голосов
/ 19 февраля 2010

Можно ли документировать файл configure.ac таким образом, чтобы doxygen мог собирать встроенные комментарии и создавать документацию для параметров, переменных и т. Д. В сгенерированных руководствах?

Спасибо

Ответы [ 2 ]

1 голос
/ 04 марта 2010

Вы должны комментировать, используя Doxygen, используя комментарии типа ##! , верно? Я не думаю, что Doxygen поддерживает подобные комментарии, но вы можете попытаться изменить Doxygen таким образом, чтобы принимать такие комментарии, затем вы можете документировать, используя обычные команды Doxygen @ var , @ cond и т. д.

Изменение может быть трудным, но вы можете попробовать изменить этот файл commentcnv.l (начиная с @line 319). Может быть, вы можете отправить письмо с помощью списка рассылки для разработчиков проекта.

0 голосов
/ 19 февраля 2010

Введены макросы Autoconf для Doxygen в Autoconf Archive . Включите макрос DX_INIT_DOXYGEN в configure.ac, а затем automake создаст цели, такие как doxygen-doc, для создания различных подмножеств документации.

...