C Doxygen组警告:组内文件结束
我试图在C头文件中使用doxygen(v1.8.9.1)C Doxygen组警告:组内文件结束,c,module,grouping,doxygen,C,Module,Grouping,Doxygen,我试图在C头文件中使用doxygen(v1.8.9.1)@defgroup注释,该注释以@{结尾,如下所示: /** @file foo.h * @brief This is a foo file */ #ifndef FOO_H_ #define FOO_H_ #include somebar.h /** @defgroup foo Foo * @details This foo file does foo stuff * @{ */ #ifdef __cpluplus
@defgroup
注释,该注释以@{
结尾,如下所示:
/** @file foo.h
* @brief This is a foo file
*/
#ifndef FOO_H_
#define FOO_H_
#include somebar.h
/** @defgroup foo Foo
* @details This foo file does foo stuff
* @{
*/
#ifdef __cpluplus
extern "C" {
#endif
/* foo declarations here with standard doxygen documentation */
#ifdef __cpluplus
}
#endif
/** @} */
#endif
这与上的示例用法相匹配,但是,当我构建此示例时,在文件结尾处出现错误警告:在组中时文件结尾处出现错误
但是,如果开头的@{
位于单独的doxygen注释中,则一切正常:
/** @defgroup foo Foo
* @details This foo file does foo stuff
*/
/** @{ */
这是一个bug还是我做错了什么?我尝试了两种不同的方式打开一个组,我把旧的组打开器放在了一个非文档注释中,doxygen显然仍然将其视为文档注释。这意味着doxygen认为我打开了两个组,只关闭了其中一个
例如
我无法使用1.8.9、1.8.9.1或github的当前head版本在windows上复制该消息。Doxyfile中的任何特殊设置(我使用了使用doxygen-g生成的设置).Hmm.这很奇怪。我没有使用普通的doxyfile,但到目前为止,它只是更改一些基本内容,如路径、项目名称摘要等,内联简单结构、调整页码的自定义latex标题,没有提取本地类,隐藏UNDO成员和类,不显示包含文件,不排序成员文档,不生成TODO列表,而不是如何使用文件而不显示文件(文件在输入中按特定顺序添加)我还检查了所有组是否以其他方式正确打开和关闭,它们是:\n如果在发布的示例中使用一个普通的Doxyfile会发生什么?如果在发布的示例中使用自己的Doxyfile会发生什么?嗯。对于两个Doxyfile,以及一个仅包含发布代码的项目(+一个有文档记录的bar()函数)没有问题。所以我在文档中做了一些错误的事情。我不知道是什么原因,因为在这个阶段,如果我检查过一次,我会检查一百次:\
/** @defgroup foo Foo
* @details This foo file does foo stuff
* @{
*/
/* @{ */ // Note, only a single leading star so should not be treated as doxygen comment, yet it is.
/* Some code and documentation that is in a group here. */
/**@} */ // Close one group here but the second, unasked-for, group is not closed yet.
/* EOF */