我刚刚安装并设置了Doxygen实例,但开箱即用它只在代码中找到TODO标签,如下所示:
/**
* @todo Foo
*/
Run Code Online (Sandbox Code Playgroud)
它似乎没有找到:
// TODO Foo
// FIXME Bar
// @todo Baz
Run Code Online (Sandbox Code Playgroud)
处理解析的大多数IDE和bug跟踪器对它们都很好,有没有一种简单的方法来配置Doxygen来找到它们并将它们列为ToDo项目?
我想让 Doxygen 显示源代码版本号作为主页或标题标题的一部分。
目前,我们的代码将版本定义为文本文字:
/*!
* \brief Text literal containing the build number portion of the
* ESG Application Version.
*/
static const char build_version_text[] = "105";
Run Code Online (Sandbox Code Playgroud)
我在互联网上搜索了一种方法,可以将上述语句中的 105 放入 Doxygen 主页(或标题),但没有运气。
背景
我们有一个构建服务器,它更新文本字符串作为每晚构建操作的一部分。文件被更新,然后签入软件配置管理系统。构建服务器还能够生成文档。我们还希望开发人员能够检查代码,在他们的工作站上构建 Doxygen 文档。
我们使用的是 Doxygen 版本 1.8.11。
在一些 doxygen 文档中,我想显示 a 的内容#define,而不是标签本身。例如,在一个 C 文件中我有
#define REPEAT_N_TIMES 10
Run Code Online (Sandbox Code Playgroud)
现在我想在我的文档中显示:
该动作进行10次。
如果我使用\ref REPEAT_N_TIMES,它会显示:
该操作已执行 REPEAT_N_TIMES 次
有没有办法显示链接的内容,而不是链接本身,例如像\ValueOf(\ref REPEAT_N_TIMES)或\contentOf(\ref REPEAT_N_TIMES)?
更新:我的 Doxygen 的配置是:
// Configuration options related to the preprocessor
ENABLE_PREPROCESSING = YES
MACRO_EXPANSION = YES
EXPAND_ONLY_PREDEF = YES
SEARCH_INCLUDES = YES
INCLUDE_PATH =
INCLUDE_FILE_PATTERNS =
PREDEFINED = WXUNUSED()=
EXPAND_AS_DEFINED =
SKIP_FUNCTION_MACROS = YES
Run Code Online (Sandbox Code Playgroud)
该MACRO_EXPANSION设置似乎改变了宏的“细节”。但我没有找到选择宏名称或其内容的方法。使用该命令\ref似乎不是正确的方式:它指的是“某物”而不是“某物”的内容
是否有我可以使用的运算符或函数,可能类似于C,我可以在其中使用类似的东西\ref *something而不是\ref something?