Doxygen для языка GNU M4 - PullRequest
       21

Doxygen для языка GNU M4

3 голосов
/ 23 марта 2011

Можно ли документировать макросы GNU M4 с помощью Doxygen или чего-то подобного?

У нас есть большая коллекция макросов, и мы хотели бы задокументировать их в комментариях и сгенерировать документацию по ним (аналогично Doxygen, JavaDoc и т. Д.)

Спасибо!

1 Ответ

1 голос
/ 30 августа 2011

Нет, это невозможно, причина в том, что doxygen нужно разобрать документ в соответствии с некоторой грамматикой.Поскольку m4 - это макропроцессор общего назначения, он может обрабатывать текстовые файлы любого типа и вообще не ограничен определенной грамматикой.Даже если бы все ваши файлы m4 были на самом деле C, doxygen нужно было бы проанализировать гибрид m4 и C, чего он не может.Doxygen ограничен поддерживаемыми языками, как указано в документации по Doxygen.

...