c++ - 为 C++ STL 头文件生成 Doxygen 文档

Question

尝试为 GNU C++ STL header (位于 /usr/include/c++/6/ 目录)生成 Doxygen 输出。它有点工作，它生成输出但结果相当微不足道 - 没有为例如 std::vector 公共(public)函数等生成文档。头文件函数看起来注释正确但仍然无法获得所需的输出。

尝试调整 Doxyfile 中的许多条目(RECURSIVE、EXTRACT_ALL 等)，但没有成功。 任何指针将不胜感激。

$ doxygen --version
1.8.13

例如，std::vector::swap() 函数的注释如下所示:

 /**
  *  @brief  Swaps data with another %vector.
  *  @param  __x  A %vector of the same element and allocator types.
  *
  *  This exchanges the elements between two vectors in constant time.
  *  (Three pointers, so it should be quite fast.)
  *  Note that the global std::swap() function is specialized such that
  *  std::swap(v1,v2) will feed to this function.
  */
void
swap(vector& __x) _GLIBCXX_NOEXCEPT
{
     //....
}

Answer 1

不是答案，但我想包含一张图片。

我按照指示获取代码，一个普通的 Doxyfile，只有 EXTRACT_ALL 设置为 YES，我得到:

我可能会忽略一些东西，但这对我来说看起来不错。 如果我忽略了某些内容，请在原始问题中指出它作为编辑。

• 您使用的文件名是什么？

一些旁白:

• 当前的 doxygen 版本是 1.8.15
• 另请查看 _GLIBCXX_NOEXCEPT 的“预处理”一章>