Doxygen 错误：找到 ';'在解析初始化列表时

Question

Doxygen 1.8.11 对以下定义感到窒息，我在不丢失警告消息的情况下尽可能地简化了它：

template <class T>
struct MySpecialization<T, void_t<decltype(std::declval<T>().foo(
                             std::declval<double>()))>> : std::true_type {};

警告是：

warning: Found ';' while parsing initializer list! (doxygen could be confused by a macro call without semicolon)

有趣的是，Doxygen 可以满足以下条件：

template <class T>
struct MySpecialization<T, void_t<decltype(std::declval<T>().foo())>> : std::true_type {};

这与foo 的定义基本相同。

我非常感谢一个解决方法。在最坏的情况下，我想以某种方式让 Doxygen 忽略这个定义。

Answer 1

我刚刚在 GitHub 中针对此问题进行了修复，请参阅 https://github.com/doxygen/doxygen/commit/985faf287233badf65fa33d21bde17afa6970d60

Answer 2

答案在docs。使用 doxygen 的 \cond 和 \endcond 命令或使用预处理器定义。

/// \cond NOPE
template <class T>
struct MySpecialization<T, void_t<decltype(std::declval<T>().foo(
                             std::declval<double>()))>> : std::true_type {};
/// \endcond

使用预处理器定义，您可以添加对 Doxygen 友好的定义。例如，Qt 项目就是这样做的。

#ifdef DOXYGEN_WORKING
template <class T>
struct MySpecialization<T, something_that_doxygen_understands> : std::true_type {};
#else
template <class T>
struct MySpecialization<T, void_t<decltype(std::declval<T>().foo(
                             std::declval<double>()))>> : std::true_type {};
#endif

并将PREDEFINED = DOXYGEN_WORKING 添加到您的配置文件中。