Doxygen如何创建文件夹的常规文档_Doxygen

Doxygen如何创建文件夹的常规文档

doxygen

Doxygen如何创建文件夹的常规文档,doxygen,Doxygen,如图所示，我想为每个文件夹添加说明：这可能吗？您可以使用\dir或@dir命令记录文件夹关于这方面的文档并不多。但我已经花了很长时间去弄清楚它是如何工作的。在所需的任何源文件中，都可以添加文件夹的文档（甚至可以为文件夹的文档创建特定文件）就你而言 /** \dir workspace * \brief "Folder description that shows up where you want" * \details More details to be displayed

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

这可能吗？

您可以使用\dir或@dir命令记录文件夹

关于这方面的文档并不多。但我已经花了很长时间去弄清楚它是如何工作的。在所需的任何源文件中，都可以添加文件夹的文档（甚至可以为文件夹的文档创建特定文件）

就你而言

/** \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.
 */

注意。。。注意你对“教程”的拼写

旁注：我注意到一个与文件夹名称相关的bug，它有一个共同的后缀。我得到以下警告：

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

代替引号来修复它。如果路径中没有空格，则此操作正常。。。否则我们需要修复错误。