doxygen - 如果在同一级别，Doxygen（或其他工具）类似地记录类和命名空间

我有一堆命名空间（包含自由函数）和类（显然包含成员函数），每一个在顶层都有一个 Doxygen 注释和一些针对其成员的 Doxygen 注释。它们位于顶级命名空间（一个用于整个项目）和二级命名空间（将项目分解为包）。像这样：

我没有任何@file意见。它们完全是多余的，因为每个组件已经有一个主注释，它附加到主类或命名空间。

我尝试通过 Doxygen 运行它，结果是一团糟：

命名空间和类在标题行和导航面板中被分成两个不同的层次结构。但我希望它们都在一棵树中，因为 egpkg2::One属于pkg2::Two.
命名空间的主要层次结构隐藏在导航面板下方的三层（项目名称 -> 命名空间 -> 命名空间列表）。它在“命名空间成员”旁边 - 谁使用它！？
文件（和目录）还有另一个层次结构。这是多余的，因为它们完全匹配命名空间（和类）的层次结构。
现在这有点离题了，但我还想在包命名空间中添加注释。这些具有分离类和名称空间的相同问题（不是什么大问题），但也显示了各种免费功能，例如operator<<(proj::pkg2::One.

有什么办法可以稍微清理一下吗？也许与狮身人面像和呼吸？

示例屏幕截图

这是 Doxygen 在上述代码中默认生成的内容（它甚至没有提到Baz和Two！），以及我更喜欢它的样子：

标签： doxygenpython-sphinx

这是一个特别可怕的 hack，但我提到它是为了记录。您可以决定 Doxygen 最好地处理类，并将所有组件命名空间（第三级命名空间）重新标记为类。像这样：

namespace proj {
namespace pkg1 {

/// @brief The Doxygen comment goes here.
#ifdef DOXYGEN
class
#else
namespace
#endif
Baz {

然后设置PREDEFINED = DOXYGEN在Doxyfile.

显然，this 的缺点是它在源代码中看起来很丑陋，而且它在文档中显示为“类”令人困惑。