c++ - 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

SHOW_FILES 必须在 Doxygen 文件中设置为 YES 除了在源文件中有 ///@file