Я использую Doxygen для документирования JavaScript API моего проекта C ++ (Qt). Идея состоит в том, чтобы написать одну конкретную документацию для интерфейсов JavaScript, а другую - для обычных классов C ++.
Один пример (datasource.dox) выглядит так:
\addtogroup JavaScriptAPI
@{
...
\class DataSource
\brief DataSource is the .... some doc goes here ....
\section formats Supported formats
....
\fn isOpen()
\brief returns true if the data source is currently open...
...
@}
Сгенерированная справка выглядит хорошо w.r.t. описание класса (или «описание объекта»), но документация по функции (isOpen (), ...) отсутствует. Doxygen создает предупреждающие сообщения, такие как:
Предупреждение: документированная функция `bool isOpen 'не была объявлена или определена.
Теперь вопрос: могу ли я каким-то образом заставить doxygen использовать мои описания функций \ fn-d? Было бы хорошо, если бы doxygen создал все эти индексы для меня ...