Doxygen 没有显示公共的、非静态的成员函数

Question

我一直在努力让以下代码摘录的文档在doxygen 中正确显示。

我已经在网上搜索过这个问题；然而，似乎没有显示的文档主要是由于成员函数/变量是私有的。尽管我似乎在记录一个公共成员函数，它也是非静态的，但我无法让 doxygen 正常工作。如果您能提供任何帮助，我将不胜感激。

/**
 * @brief Algorithm abstraction.
 *
 * @tparam float_t `float` or `double`.
 * @tparam int_t `int64_t` or similar.
 * @tparam StepPolicy Policy for selecting a step-size.
 * @tparam OraclePolicy Policy for getting first-order information.
 */
template <class float_t, class int_t, template <class, class> class StepPolicy,
          template <class, class> class OraclePolicy>
struct Algorithm : public StepPolicy<float_t, int_t>,
                   public OraclePolicy<float_t, int_t> {
  /**
   * @brief Default constructor.
   *
   */
  Algorithm() = default;
  /**
   * @brief Constructor with a step-size.
   *
   * @param[in] step Non-negative step-size value.
   */
  Algorithm(float_t step) : StepPolicy<float_t, int_t>{step} {}

  /**
   * @brief Set the initial step-size of the algorithm.
   *
   * @param[in] step Non-negative step-size value.
   */
  void set_stepsize(float_t step) { StepPolicy<float_t, int_t>::set(step); }
  /**
   * @brief Get the current step-size of the algorithm.
   *
   * This does *not* change the state of StepPolicy.
   *
   * @return float_t Current step-size.
   */
  float_t get_stepsize() const { return StepPolicy<float_t, int_t>::get(); }
  /**
   * @brief Get current step-size based on the algorithm's state.
   *
   * @param[in] k Current iteration count.
   * @param[in] N Dimension of `x` and `dx`.
   * @param[in] x Current decision vector.
   * @param[in] dx Current first-order information.
   * @return float_t Current step-size.
   */
  float_t get_stepsize(const int_t k, const int_t N, const float_t *x,
                       const float_t *dx) {
    return StepPolicy<float_t, int_t>::get(k, N, x, dx);
  }

private:
  int_t k{0};
};

我不确定doxygen 是否与有效 代码摘录有关，但上面的代码确实可以编译。它与模板和继承有关吗？我错过了什么吗？我的意思是，对于非继承模板类，doxygen 可以完成它的工作。

顺便说一句，我的目录中没有具体的StepPolicy 或OraclePolicy。此外，我可以看到构造函数得到正确记录。我只是卡住了。

我可以在这里分享我的Doxygen 文件，它基本上只是MathJax 相关设置中覆盖的默认值。

提前感谢您的宝贵时间。

Answer 1

从v1.8.14开始，不存在这样的问题。显然，问题是 bug，doxygen 的维护者已修复。