更改生成的函数签名的 doxygen 格式 HTML
Change doxygen format of function signatures in the generated HTML
我使用 doxygen 来记录 C++ 代码。在当前项目中,我使用以下格式进行函数签名:
MyClass(MyClass&& other)
但是,在生成的 HTML 文档中,简短描述具有以下签名:
MyClass (MyClass &&other)
详细描述有这个签名:
MyClass ( MyClass && other )
有没有办法要么保留原始格式,要么改变 doxygen 格式化签名的方式?我在 customization or configuration 页面中没有找到与此问题相关的任何内容。
编辑:根据评论中的讨论更新了签名。
简答:否
长(且更正确)的答案:是的,如果您愿意修改源代码。
文件 memberdef.cpp
具有以下内容(我今天看到的第 1668 行):
// *** write arguments
if (argsString() && !isObjCMethod())
{
if (!isDefine() && !isTypedef()) ol.writeString(" ");
最后一行将在简要说明中添加 space。 (我已经通过删除它并重新编译验证了这一点。)
至于详细说明,就是设置一个table,用<td>(</td>
打开参数列表。你可能更容易摆脱那个 space,但要做好它可能需要修改源代码。
我想最好的选择是自己推出,或者请求开发人员添加功能。
我使用 doxygen 来记录 C++ 代码。在当前项目中,我使用以下格式进行函数签名:
MyClass(MyClass&& other)
但是,在生成的 HTML 文档中,简短描述具有以下签名:
MyClass (MyClass &&other)
详细描述有这个签名:
MyClass ( MyClass && other )
有没有办法要么保留原始格式,要么改变 doxygen 格式化签名的方式?我在 customization or configuration 页面中没有找到与此问题相关的任何内容。
编辑:根据评论中的讨论更新了签名。
简答:否
长(且更正确)的答案:是的,如果您愿意修改源代码。
文件
memberdef.cpp
具有以下内容(我今天看到的第 1668 行):// *** write arguments if (argsString() && !isObjCMethod()) { if (!isDefine() && !isTypedef()) ol.writeString(" ");
最后一行将在简要说明中添加 space。 (我已经通过删除它并重新编译验证了这一点。)
至于详细说明,就是设置一个table,用
<td>(</td>
打开参数列表。你可能更容易摆脱那个 space,但要做好它可能需要修改源代码。
我想最好的选择是自己推出,或者请求开发人员添加功能。