Doxygen不会为独立函数生成文档

Question

我使用的doxygen设置非常适合类，结构和命名空间，但不为独立函数生成任何文档。

例如，不会为这些方法生成任何内容：

#ifndef STRING_UTILS_H
#define STRING_UTILS_H 1
/// @file
/// @brief Trim whitespace from the start of the string
/// @param s - The string to left trim
/// @return the trimmed string
std::string ltrim(const std::string& s);
/// @brief Trim whitespace from the end of the string
/// @param s - The string to right trim
/// @return the trimmed string
std::string rtrim(const std::string& s);
/// @brief Trim whitespace from both sides of the string
/// @param s - The string to trim
/// @return the trimmed string
std::string trim(const std::string& s);
#endif

Answer 1

除了在源文件中具有/// @file之外，还必须将SHOW_FILES设置为 Doxygen 文件中的YES