c - 使用 doxygen 文件头作为模块描述

Question

我想知道是否有可能将 doxygen 文件头描述也用于模块描述。

/**
   \file               
   \brief         Some brief info
   \details       more Details
*/
/**
   \defgroup Views
   \brief (Same as header doxy)
   \details (Same as header doxy)
*/

为了避免冗余，我不会复制文本。如果我将 defgroup 移动到文件顶部，我只会得到模块中提到的文件名，而不是描述。我已经尝试了一些组合，但从未实现我的目标。详细和简要文本位于模块文档或文件文档中。有人知道如何重用文本吗？

非常感谢，

强尼

Answer 1

我自己找到了解决方案。 您可以使用 doxy 命令@copydoc 来复制文档。

我的 test.h 代码如下所示:

/**
   \file          test.h
   \brief         Some brief info
   \details       more Details
*/
/**
   \defgroup Views
   @copydoc view.h
*/