C++ Doxygen-没有名称空间中函数的详细描述

我试图让doxygen 1.8.7在HTML输出中包含详细的描述。例如，给定以下文件：

/** \file iniparse.h */

namespace ini {
/** \brief A brief description.
 *
 * A longer description.
 */
inline void parse() {}
}

我的iniparse.h HTML包含ini:：parse的一个条目，其中包含文本“简要说明。更多…”，“更多…”部分是指向同一页面中不存在的锚的断开链接。而文本“更长的描述”在生成的HTML中不会出现

---

如果我去掉了名称空间，只在任何名称空间之外定义一个函数parse（即，

：：parse

），一切都会正常工作。有人能告诉我如何在名称空间中获得相同的行为吗？谢谢。

事实证明，这个问题是由三个因素共同造成的。首先，doxygen中的一个普通老错误：

第二，即使修复了bug，也需要生成名称空间页面，否则仍然会出现断开的链接。因此，您需要在doxy文件中设置

SHOW_NAMESPACES=YES

第三，除非您有EXTRACT_ALL=YES，否则您必须通过向名称空间附加一条Doxygen注释来确保名称空间本身是文档化的。因此，您需要：

//! The ini namespace
namespace ini {
...
}

---

一方面，如果您想要对名称空间的内容进行文档化，那么要求对名称空间进行文档化可能是有意义的。然而，奇怪的是，doxygen显示了文档的第一部分，即使没有名称空间文档。因此，我认为这仍然是一种缺陷，但至少我现在知道如何解决它。

您能以某种方式显示您的

Doxygen

文件以查看您的设置吗？当然。它有点大，但我把它贴在这里：