在doxygen中多次使用相同的文本

Question

我有幾個函數，應該在doxygen中描述，其中80％的描述是相同的。 我可以將它複製粘貼在它們上面，但有時這種描述正在發生變化，並且支持所有這些功能的變化正變得令人頭疼。

doxygen有沒有辦法創建一個命名的文本塊，只需鍵入一次，每個函數都可以使用它？

類似的東西：

//! /textblock <supername> that is the text that I would like to have just once, but that should appears in different places in documentation 
... 
//! my function 1. /useblock <supername>. Just as it is. 
void func1() { return; } 
... 
//! my function 2. /useblock <supername>. Yeah, make sense. 
void func2() { return; } 
... 
//! my function 3. /useblock <supername>. Such great it is. 
void func3() { return; } 

Answer 1

我用在Doxygen的「別名」自定義命令執行「片段」。請參閱https://www.stack.nl/~dimitri/doxygen/manual/custcmd.html。儘管解釋使得它看起來像只能用於函數類型的東西，但它對於重複的文本來說很棒。