Doxygen:创建专门页面

Doxygen:创建专门页面,doxygen,deprecated,Doxygen,Deprecated,我终于想出了如何使用deprecated将函数标记为消失。我想生成的是一个列在“相关页面”上的附加页面(很像generate_DEPRECATED),它允许我列出已更改的API 如果我们拉一个函数 doFoo(int,SOMECLASS) 代替 doFoo(uInt_64、SOMECLASS和errInstance) 我想要的是有一个我可以放进去的页面 更改: doFoo(int, SOMECLASS) removed: Use doFoo(uInt, SOMECLASS, &errIn

我终于想出了如何使用deprecated将函数标记为消失。我想生成的是一个列在“相关页面”上的附加页面(很像generate_DEPRECATED),它允许我列出已更改的API

如果我们拉一个函数 doFoo(int,SOMECLASS)

代替 doFoo(uInt_64、SOMECLASS和errInstance)

我想要的是有一个我可以放进去的页面

更改:

doFoo(int, SOMECLASS) removed: Use doFoo(uInt, SOMECLASS, &errInstance)
让事情变得更糟;我不知道如何在不重新启用标题中的旧调用的情况下执行此操作,尽管它现在已被删除


欢迎您的建议。

对于类似的内容,我创建了一个包含文本和代码块的大注释文件:

/*! 
\page changed Changed

<b>Changed:</b>

/code
doFoo(int, SOMECLASS) removed: Use doFoo(uInt, SOMECLASS, &errInstance)
/endcode

*/
/*!
\换页
改变:
/代码
删除doFoo(int,SOMECLASS):使用doFoo(uInt,SOMECLASS和errInstance)
/端码
*/

如果要定义自己的命令(如\change),其行为类似于\deprecated,请结合别名定义查看\xrefitem命令


有关更多信息,请参阅

您不需要在输入中包含该文件吗?如果是这样,它不会出现在文件列表中吗?这是不可取的?可能是。我不显示文件列表;所以,这对我来说不是问题。我想你可以把那页钉在现有文件的底部。我明白了。我想这是Doxygen可以做得更好的地方。我发现Doxygen既出色又令人沮丧。如果扩展名为.doc、.dox或.txt,则Doxygen不会在文件列表中显示该文件。