2010-07-30 4 views
4

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

/** 
* 
* Descriptions and stuff 
* 
*/ 

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

/*! 
* 
* Descriptions and stuff 
* 
*/ 

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

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

Но Doxygen анализатор не позволяет этот синтаксис. Поэтому мои вопросы, если есть способ, чтобы определить собственные стили комментариев.

ответ

2

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

Смотрите эту страницу на documentation blocks в документации Doxygen:

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

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

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

или

///////////////////////////////////////////////// 
/// ... text ... 
///////////////////////////////////////////////// 
+0

Да, я уже попробовал первый и найти его довольно хорошо потому что это своего рода приятно для глаз .. больше, чем второй пример ИМХО. Я просто подумал, что может быть способ настроить стиль, спасибо в любом случае :) – Exa