Doxygen如何为文件夹的一般文件

Question

我想为每个文件夹添加说明，如图所示：

这可能吗？

Answer 1

您可以使用\ dir或@dir命令

记录文件夹

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

关于此的文档并不是很好。但我确实已经花时间弄清楚它是如何工作的。在您想要的任何源文件中，您可以添加该文件夹的文档（甚至可以为该文件夹的文档创建特定文件）。

在你的情况下

/** \dir workspace
 *  \brief "Folder description that shows up where you want"
 *  \details More details to be displayed on the folder's page.
 */


/** \dir workspace/SWTtutotial
 *  \brief "Folder description that shows up where you want"
 *  \details More details to be displayed on the folder's page.
 */

注意...注意拼写“教程”;）

附注：我注意到与文件夹名称相关的错误有一个共同的后缀。我收到以下警告：

file.cpp:180: warning: \dir command matches multiple directories.
  Applying the command for directory /sources/
  Ignoring the command for directory /testsources/

第180行的评论导致此警告

/**
 * \dir "sources"
 * \details Adding details later 3...
 */ //works but complains about also matching "testsources".  Doxygen Bug?

我使用\dir /sources而不是引号来修复它。如果路径中没有空格，这是可以的......否则我们需要修复错误。