2011-10-28 29 views
7

我在我的C++代碼中有typedef結構。截至目前,它們被列爲\var typedef。有一個更好的方法嗎?下面是我的例子:我應該如何用Doxygen分類typedef?

/*! \var typedef etc 
* \brief A type defined structure for etc 
* 
* \param x type- Variable declaration for x 
* \param y type- Variable declaration for y 
*/ 

我知道我甚至不應該說param。還有什麼可用的?

+1

爲什麼'typedef'?這是C++,而不是C. – Pubby

+5

@ Pubby8:''typedef's仍然用於C++來提高代碼的可讀性。 'typedef'的一個流行用法是創建指向函數的指針。另一個是模板。 –

+2

@ThomasMatthews我可以用這種方式使用typedef,但爲什麼'typedef struct'而不是'struct'? – Pubby

回答

21

如果將註釋塊放在typedef的前面,則不需要使用任何特殊命令。

/** This is the documentation for the following typedef */ 
typedef MyClass MyTypedef; 

如果你喜歡把它之後typedef的使用:只有

typedef MyClass MyTypedef; 
/**< This is the documentation for the preceding typedef */ 

當註釋塊必須在不同的位置比實際的typedef,你需要使用\類型定義。