【问题标题】:Doxygen: warning end of file while inside a groupDoxygen:在组内时警告文件结束
【发布时间】:2015-05-27 12:43:04
【问题描述】:

正如标题所说,Doxygen 似乎没有注意到我关闭该组的“}”。这是我的 Python 文件的样子:

##
#   @defgroup api_ironpy IronPython
#   @brief IronPython API
#
#   @defgroup api_ironpy_foo Foo
#   @ingroup api_ironpy
#   @{
#

My Foo class definition goes here...

##
#   @}
#

即使我删除我的类定义并只创建组,我也会收到相同的警告,所以我的类不会干扰。知道是什么原因造成的以及如何解决吗?我使用的是 Doxywizard 创建的默认设置,这是我的 Doxygen 项目中唯一的源文件。

我在另一个项目(C++/C# 而不是 Python)中创建组时使用了相同的过程,没有问题,在这些文件中它看起来像这样:

///
/// @defgroup api_c_cpp C/C++
/// @brief C/C++ API
///
/// @defgroup api_c_cpp_bar Bar
/// @ingroup api_c_cpp
/// @{
///

Code goes here...

///
/// @}
///

【问题讨论】:

  • 使用 Doxygen 1.8.9.1,您的示例文件可以在我的系统上正常运行,不会出现错误或警告。
  • 这很有趣,我使用相同版本的 Doxygen 并收到警告。您确实尝试了第一段代码而不是第二段?

标签: python doxygen


【解决方案1】:

我已经使用 doxygen 版本 1.8.131.8.11 测试了以下内容。

当我按以下方式关闭组时,它可以工作。请注意## @} 之后和最终# 之前的额外新行。

## @} 

#

我不知道为什么会这样,但确实有效。

我已经用this example (pythonSample.py/cfg) 进行了测试。

【讨论】:

  • 注意当前doxygen版本是1.8.18
猜你喜欢
  • 2023-04-01
  • 2015-04-13
  • 2018-02-08
  • 2011-03-31
  • 2013-09-16
  • 1970-01-01
  • 2015-04-13
  • 2015-12-18
  • 1970-01-01
相关资源
最近更新 更多