Doxygen 在 \page 中显示文档

Question

在 C 项目中，我必须将代码记录在专用的 .dox 文件中，而不是 C 文件本身。

.dox 文件的摘录：

/*! \page intro2 Introduction2
Sample text

\fn void foo(void)
@brief foo

foo does nothing.
*/

文档将出现在定义我的函数的 foo.h 文件下的“文件列表”中。我的页面将只显示“示例文本”行。

有没有办法在“示例文本”行之后获取页面本身的文档？

我知道我可以通过小组来实现这一目标。但由于 Doxygen 管理组和页面的方式不同，我更喜欢在 \page 中获取文档。

谢谢，

Answer 1

/*! \page intro2 Introduction2
Sample text

foo

foo does nothing.
*/

.h 对于 foo

\fn void foo(void)
@brief foo

不完全是您想要的，但我认为它现在将全部放在一个页面中，您可以单击该链接来阅读有关该功能的链接。如果您真的希望文档出现在页面中，您也可以尝试使用 \copydoc。