我有3个文件:
test.c
int table[] = {
#define X(val) val,
#include "test.x"
#undef X
};
void level2(void) {
level3();
level4();
}
void level3(void) {
level4();
}
test2.c
void level1(void) {
level2();
level3();
level4();
}
void level4(void) {
}
test.x
X(1)
X(2)
X(3)
我使用 doxygen 为这些函数创建调用图。这是我的预期:
- level1:
- 参考 level2()、level3() 和 level 4()。
- level2:
- 参考文献级别 3() 和级别 4()。
- 由 level1() 引用。
- level3:
- 参考文献级别4()。
- 由 level1() 和 level2() 引用。
- level4:
- 由 level1()、level2() 和 level3() 引用。
但这是我得到的:
- level1:
- 参考 level2()、level3() 和 level 4()。
- level2:
- level3:
- level4:
看来 test.c 上的 X-macro 是罪魁祸首。我设法让它发挥作用
2 件事(两者都可以):
- 重命名
test.x
所以 doxygen 找不到它。它会显示警告,但是
调用图是正确的。
- 在末尾添加尾随换行符
test.x
。通常文件会结束
之后立马X(3)
.
问题:
如何在不编辑文件的情况下从 doxygen 中获得可靠的 callgraph?
是否有我需要更改的设置或者这是一个简单的错误?
我对 xmacros 有不同的经验。一般来说,Doxygen 会将宏视为正确的声明,而不是实际预处理它们。为了让宏工作(这包括 x 宏)。一般来说:
- Set
MACRO_EXPANSION=yes
- 任意设定
EXPAND_ONLY_PREDEF=yes
(这将使 Doxygen 扩展all宏)或
- 将宏的名称添加到
EXPAND_AS_DEFINED
.
另外,请注意这一点:http://www.doxygen.nl/manual/config.html#cfg_skip_function_macros http://www.doxygen.nl/manual/config.html#cfg_skip_function_macros
为了让您了解 xmacros 和 Doxygen 的功能,我可以从中生成正确的文档:https://github.com/couchbase/libcouchbase/blob/master/include/libcouchbase/error.h#L95 https://github.com/couchbase/libcouchbase/blob/master/include/libcouchbase/error.h#L95
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)