Как определить собственные стили комментариев doxygen?

Question

Я хотел бы знать, возможно ли определить собственные стили комментариев doxygen.Обычный стиль выглядит примерно так (в стиле Javadoc):

/**
*
*   Descriptions and stuff
*
*/

или (при использовании Qt):

/*!
*
*   Descriptions and stuff
*
*/

Я бы предпочел что-то вроде

/*!===============================================================
*
*   Descriptions and stuff
*
================================================================*/

Но синтаксический анализатор doxygen не разрешает этот синтаксис.Поэтому мои вопросы таковы: если есть способ определить собственные стили комментариев .

Answer 1

Я не думаю, что вы можете определить свои собственные стили комментариев, но с некоторыми небольшими изменениями в формате, он может совпадать.

См. Эту страницу в блоках документации в документации Doxygen:

Некоторым людям нравится делать свои комментарии более заметными в документации.Для этой цели вы можете использовать следующее:

/********************************************//**
 *  ... text
 ***********************************************/

(обратите внимание на 2 слеша, чтобы завершить блок нормального комментария и начать специальный блок комментария).

или

/////////////////////////////////////////////////
/// ... text ...
/////////////////////////////////////////////////