Doxygen未生成全局函数文档

Question

我有一个C头文件，其中声明了许多方法，所有方法都包含有效的doxygen标记以生成文档，但是除非我将EXTRACT_ALL设置为true，否则doxygen无法为方法创建任何文档，但即使在这种情况下，方法也只出现在头文件的文档中...我希望有一个“函数”集合点，其中有一个方法列表，我可以点击它们...这个可能吗？（我的输出优化为C/PHP，但将其设置为其他内容也没有任何帮助）...

- Ferenc Deak

Answer 1

如果您想为全局函数生成文档，则必须记录文件。以下是一个示例：

/**
 * @file buffer.h
 *
 * Interfaces to Data Buffer.
 *
 * This header define the interfaces of general purpose dynamic data buffer that
 * implemented by Equinox.
 */
#ifndef _EQUINOX_BUFFER_H
#define _EQUINOX_BUFFER_H

- UltimaWeapon

---

最好不要包含文件名。如果省略文件名，则假定文件名已知。这也避免了在头文件的名称更改时需要更新名称的麻烦。 - gnash117