强制 doxygen 模块以小写字母开头

Question

我正在使用 doxygen 记录一个 C 项目，并将文件集合分组到模块中（其中每个模块包含 ac 样式类的所有文档）。我所拥有的一切工作正常，除了所有模块名称都以大写字母开头，即使我使用全小写名称创建模块组也是如此。

例如，以下 doxygen 注释将在我的文档中生成一个模块“Foobar”，即使我添加到组“foobar”并希望将该模块称为“foobar”：

    /**
     *@addtogroup foobar
     *@{
     * (some documentation elements...)
     *@}
     */

虽然大写不会以任何严重的方式影响文档，但我想修复它以保持一致性（并且因为我不能让自己放手）。谷歌已经干了，有什么建议吗？

Answer 1

我差点在doxygen 手册中错过了这一点：

要定义组，您应该将 \defgroup 命令放在特殊的注释块中。该命令的第一个参数是一个标签，应唯一标识该组。第二个参数是组的名称或标题，它应出现在文档中。

所以你应该能够做到

@addtogroup foobar foobar