Question

我已经将我们的c ++类注释更新为doxygen格式，它们看起来不错......但命名空间列表/选项卡根本没用。我们有一个父命名空间，例如john，然后是每个库或功能区域的子命名空间，例如john::graphics，john::sound等。 Doxygen仅列出单个命名空间：john。我是否必须简单地更改某些设置，或者是否必须记录我的命名空间以供doxygen选择它们？

Answer 1

一般情况下，您必须记录Doxygen的任何内容，以确定它是否重要。包含的命名空间。但你不必特别好地记录它们;只是简单地记下它们的用途就足以让Doxygen记录它们。

Answer 2

如果设置EXTRACT_ALL Build标志（参见http://www.doxygen.nl/manual/config.html#cfg_extract_all），这将从嵌套的命名空间信息中提取信息，而无需专门记录它们。

Answer 3

我有一个类似的问题，Doxygen没有看到命名空间是嵌套的。我通过指定范围来修复它：

之前：

/**
* @namespace outer
* @brief the outer namespace
*/
namespace outer
{
  /**
  * @namespace inner
  * @brief the inner namespace
  */
  namespace inner
  {
  }
}

后：

/**
* @namespace outer
* @brief the outer namespace
*/
namespace outer
{
  /**
  * @namespace outer::inner
  * @brief the inner namespace
  */
  namespace inner
  {
  }
}

Doxygen不列出嵌套的命名空间

3 个答案: