带参数的 doxygen 别名：（经典）linebr 问题

Question

• 考虑以下 doxygen 别名：

ALIASES += "sbl_add_package_main_class{4}=\addtogroup \1-ref-manual ^^ @{ ^^ \class \2 ^^ \brief \3 ^^ \4 ^^ @}"

或等效

ALIASES += sbl_add_package_main_class{4}="\addtogroup \1-ref-manual ^^ @{ ^^ \class \2 ^^ \brief \3 ^^ \4 ^^ @}"

• 在以下 C++ 代码上运行 doxygen (1.8.18) 时

  /**
       \sbl_add_package_main_class{Molecular_potential_energy, T_Phi_psi_dihedral_angles_visitor,
        Defines iterator over all successive pairs of dihedrals.,
       \details Defines iterator over all successive pairs of dihedrals.  
       \tparam CovalentStructure The type of the input covalent structure
       }
    */  
    template <class CovalentStructure>
    class T_Phi_psi_dihedral_angles_visitor
    {
      
    public:
      
      typedef T_Phi_psi_dihedral_angles_visitor<CovalentStructure> Self;
      typedef CovalentStructure                               Covalent_structure;

      static inline Iterator begin(const CovalentStructure& C);

      static inline Iterator end(const CovalentStructure& C);
      
    };//end class T_Phi_psi_dihedral_angles_visitor

• 我收到以下警告：

warning: the name '\_linebr' supplied as the argument of the \class, \struct, \union, or \include command is not an input file

这对我来说没有任何意义，因为第二个参数 T_Phi_psi_dihedral_angles_visitor 格式正确。

我曾尝试添加/删除回车，在别名中添加/删除^^...完全失败！

有什么线索吗！？

非常感谢，弗雷德里克。

Answer 1

基于 1.8.20 版本，我刚刚将提议的补丁推送到 github（拉取请求 8003，https://github.com/doxygen/doxygen/pull/8003）。

请注意：

• args \3 和 \4 之间的 ^^ 不应存在（将导致警告），\details 确保 \brief 已结束。这些警告有待进一步调查。
• 也使用了物理换行符，因此必须小心使用。
• \details 行的末尾也有 2 个空格，我不知道它们是不是故意的，但是（至少）行尾的 2 个空格意味着 Markdown 中的一个额外的新行语法。

编辑

• 关于 ^^ 在 \3 和 `4` 之间的警告，我刚刚将一个提议的补丁推送到 github（拉取请求 8004、https://github.com/doxygen/doxygen/pull/8004）。

2020 年 9 月 17 日编辑 上述提议的补丁都已集成在 github 上的 master 中