Doxygen 无法解析模板化返回类型

Question

我目前正在使用 Doxygen 记录我的代码。看起来 Doxygen 无法处理模板化返回值。我的问题：

/** 
 *  Retrieves all edges from the graph.
 *  @param gID The ID of the graph.
 *  @return A list containing pairs of vertices, denoting the edges in the graph.
 */
 int GetEdges(const int& gID); // Works fine

/** 
 *  Retrieves all edges from the graph.
 *  @param gID The ID of the graph.
 *  @return A list containing pairs of vertices, denoting the edges in the graph.
 */
 list<pair<int,int>> GetEdges(const int& gID); // PROBLEM

第二个函数没有记录。更糟糕的是；现在，Doxygen 会跳过它下面的所有函数。不知何故，doxygen 似乎无法处理 list> 返回值。

有谁知道为什么以及如何改变这个？先感谢您。

Answer 1

也许 Doxygen 不支持声明模板的新方式？较旧的 C++ 标准（我认为直到 C++03）仅允许 list >。末尾的两个 > 符号之间应该有一个空格，否则编译器会将它们解释为 >> （右移）运算符。

一些较新的编译器重新调整了此语法，它是即将推出的 C++0x 标准的一部分，但也许 doxygen 还无法识别它。