Doxygen краткое описание внутри макроподстановкам

Question

Рассмотрим следующий C++ декларации макроса:

#define DECLARE_OBJECT_HANDLE(x) \ 
typedef struct x##HandleTag *x##Handle; \ 
typedef struct x##Handle *P##x##Handle 

Я хочу, чтобы отметить свою вторую декларацию указателя с некоторыми комментариями Doxygen. В идеале я хотел бы, чтобы второй дескриптор имел ссылку на первую, только с кратким описанием, в котором говорится, что это указатель на этот тип.

Я изменил мой макрос:

#define DECLARE_OBJECT_HANDLE(x) \ 
typedef struct x##HandleTag *x##Handle; \ 
/** 
* \brief Pointer to x##Handle. 
*/ \ 
typedef struct x##Handle *P##x##Handle 

Я был очень удивлен, когда я узнал, что это как-то работает! К сожалению, есть дополнительная секция для каждого typefef с каким-то странным характером:

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

Есть ли способ предотвратить это?

PS: Я использую doxygen версию 1.8.12 на Window 8.1 64-bit.

Answer 1

Как было отмечено в комментариях, сверхъестественный характер, я имел в виду точка пуля неупорядоченный список.

Я задал этот вопрос по списку развития кислорода, но никто не ответил.

Решение:

опустить * перед \brief doxycommand

PS: Оригинальный код работает везде вне макроподстановкам.

Answer 2

Это будет немного сложно для doxygen, чтобы получить правильный поток в случае смешивания, определяет, комментирует и вводит typedefs. Может быть, следующее дает некоторые намеки/идеи (как это не 100% ясно, что вы пытаетесь достичь):

/** Handle */ 
#define HT(x) \ 
typedef struct x##HandleTag *x##Handle 

/** Pointer to #HT(x) */ 
#define PHT(x) \ 
typedef struct x##Handle *P##x##Handle 

/** Doing both */ 
#define DECLARE_OBJECT_HANDLE(x) \ 
HT(x); \ 
PHT(x)