Я просто начинаю с Doxygen и сделал значительный поиск на этом, поэтому простите мне, если существует очевидный ответ.
Я работаю над встроенным проектом, где функции могут быть отмечены как debug
или nodebug
перед типом возврата. В большинстве наших библиотек мы используем условный макрос для установки libname_debug
к также debug
или nodebug
наверху файла, и затем каждая функция снабжена предисловием с libname_debug
.
В целях документации я хотел бы сделать, чтобы Doxygen уехал libname_debug
из функциональной документации. Это загромождает функциональный список и мешает видеть типы возврата каждой функции.
Действительно ли возможно отметить файл в некотором роде, таким образом, Doxygen пропустит тот символ? В данный момент я переношу каждый экземпляр в @cond / endcond:
/** @cond */ libname_debug /** @endcond */
Но это - боль и добавляет дополнительную разметку к источнику.
Вы можете определить макросы в файле конфигурации doxygen. Примерно так
PREDEFINED += libname_debug