使用 Doxygen 在 C 中记录函数

Question

我有一个项目，我正在使用 Doxygen 为其生成文档。类的文档很好，但我也有一些用于创建对象等的非成员函数。我也希望将这些记录在案，但无论我尝试什么，Doxygen 都不会生成文档我放在函数上方的评论。为什么 Doxygen 不会为全局命名空间中的函数生成文档，我需要做什么才能让它工作？

原文由 Paul 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 1

在 \fn \\*! \class *\

http://www.doxygen.nl/manual/docblocks.html 寻找“其他地方的文档”

http://www.doxygen.nl/manual/commands.html#cmdfn

它的工作方式类似于记录成员函数

原文由 Pieter 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 2

只有在记录了它们的类时，才会记录作为类成员的实体。在命名空间范围内声明的实体只有在它们的命名空间被记录时才会被记录。在文件范围内声明的实体只有 在它们的文件被记录时才会被记录。

因此，要在全局命名空间中记录一个自由函数，您还需要在头文件中声明它的某处这样的行：

 /** @file */

或者像这样：

 /*! \file */

原文由 Oktalist 发布，翻译遵循 CC BY-SA 4.0 许可协议