Функциональные макросы документа без оценки, если/else с доксигеном ⇐ C++

[Anonymous]

Я пытаюсь документировать файл заголовка, который имеет различные «перегрузки» при анализе C или C ++. < /p>

Код: Выделить всё

#ifdef __cplusplus

/// myfuncA
void myfuncA();

/// MYMACRO_A
#define MYMACRO_A() \
myfuncA();

#else

/// myfuncB
void myfuncB();

/// MYMACRO_B
#define MYMACRO_B() \
myfuncB();

#endif

Я хочу, чтобы все четыре этих функций и макросов были собраны и индивидуально документированы доксигеном. Это разумный вариант использования в моем приложении; Это специфические перегрузки C и C ++ для основной функции, и DOC будет указывать, каким можно назвать, с помощью которого язык. < /p>
Увы, оказалось невозможным сделать доксиген одновременно, документируя все четыре из них!

Код: Выделить всё

ENABLE_PREPROCESSING = YES
MACRO_EXPANSION      = YES
SKIP_FUNCTION_MACROS = NO

Затем доксиген оценит ifdef __cplusplus до 0 и документировать только myfuncb и mymacro_b .
Альтернативно, когда я устанавливаю

Код: Выделить всё

ENABLE_PREPROCESSING = NO

then Doxygen will not document any macros at all, and so document only myfuncA and myfuncB.
Attempted solutions

[*]I have tried every combination of MACRO_EXPANSION and EXPAND_ONLY_PREDEF, and Разоблачение макросов для expand_as_defined и предопределено без успеха.
[*] Я попытался настройка

Код: Выделить всё

ENABLE_PREPROCESSING = YES
PREDEFINED = ifdef __cplusplus=
< /code>
так что доксиген удалял ветви #if < /code> перед началом анализа и оценки,
, но этот ужасный взлом слишком сложный для моего приложения. Использование @def 

и @fn требует доксигена в конечном итоге встречает реальную подпись. Тогда можно использовать

Код: Выделить всё

ENABLE_PREPROCESSING = YES
MACRO_EXPANSION      = YES
SKIP_FUNCTION_MACROS = NO

# crucially...
PREDEFINED_IN_TURN = __cplusplus=0 __cplusplus=1
< /code>
Но, увы, такого ключа нет (и кажется нетривиальным, чтобы взломать). Конечно, это не сразу же работает с моим примером кода, который использует #ifdef 

over #if .
Функционирование, но инвазивное решение состоит в том, чтобы рефакторировать код, такой
, что каждый #if/ #else филиал исследуется, когда макро, как

Код: Выделить всё

DOXYGEN

определено. Это требует удаления всех положений #ELSE < /code>:

Код: Выделить всё

#if defined(__cplusplus) || defined(DOXYGEN)
...
#endif
#if !defined(__cplusplus) || defined(DOXYGEN)
...
#endif
< /code>
вместе с Doxyfile
ENABLE_PREPROCESSING = YES
MACRO_EXPANSION      = YES
SKIP_FUNCTION_MACROS = NO

# crucially
PREDEFINED = DOXYGEN

увы Компиляторы (но не доксиген) с использованием #if 0 :

Код: Выделить всё

#ifdef __cplusplus

/// myfuncA
void myfuncA();

#define MYMACRO_A() \
myfuncA();

#if 0
/// MYMACRO_A
void MYMACRO_A();
#endif

#else

/// myfuncB
void myfuncB();

#define MYMACRO_B() \
myfuncB();

#if 0
/// MYMACRO_B
void MYMACRO_B();
#endif

#endif

Документация теперь будет включать Myfunca , myfuncb , mymacro_a и mymacro_b Но, увы, последние два будут указаны как функции , а не как макрос. В противном случае, какой разумный, надежный метод для достижения документирования всех четырех объектов, где последние два правильно сообщаются как макросы?>

Подробнее здесь: https://stackoverflow.com/questions/795 ... th-doxygen