C++編程語言應(yīng)用廣泛，在很多領(lǐng)域中都體現(xiàn)了非常重要的作用。編程人員應(yīng)用它能夠在很到程度上提高程序開發(fā)的效率。在這里我們先來了解一下有關(guān)C++ Doxygen的應(yīng)用方式，以方便大家的理解。#t#

用C++ Doxygen進(jìn)行可自動文檔化的代碼注釋，可從代碼中提取注釋生成幫助文檔。

在使用Doxygen時將需要安裝下列軟件：

1、安裝Doxygen1.4.7，建議安裝在“D:\Program Files\doxygen”

2、安裝Graphviz-2.13，用于C++ Doxygen生成類圖、關(guān)系圖等圖形，建議安裝在D:\Program Files\ATT。

3、安裝HtmlHelp1.3，用于生成CHM幫助文件，如果已安裝了HtmlHelp其他版本則跳過。

下面對三種常見形式舉例。

A. 文件頭注釋，\file, \brief

B. 類/結(jié)構(gòu)體等的定義注釋，先寫名稱，再寫概要說明

C. 函數(shù)定義說明，先寫名稱，再寫概要說明，然后寫參數(shù)說明、返回值、注意事項、參見鏈接等

在函數(shù)定義中常用的有（1）參數(shù) param（2）返回值 return （3）參見 see（4）注意項 note等

參數(shù)可指定in/out，例如@param[out] dest、@param[in,out] buffer

D. 成員變量的注釋，如果注釋寫在變量右邊，則加“<”，例如//!< ……

更深層次的標(biāo)記請查看C++ Doxygen幫助中的“Documenting the code”，Doxygen用法后面演示說明。

//! \file Ix_Observer.h A. 文件頭注釋，用于在幫助文件中列出文件列表  
//! \brief 定義出版者和觀察者的接口Ix_Subject、Ix_Observer  
#pragma once  
struct Ix_Subject;  
struct Ix_Observer;  
//! 出版者的接口 B. 類/結(jié)構(gòu)體等的定義注釋  
/*! 出版者就是將要被觀察的對象  
\interface Ix_Subject  
*/  
struct Ix_Subject  
{  
//! 添加觀察者 C. 函數(shù)定義注釋  
/*!  
\param observer 要添加的觀察者  
\see Ix_Observer  
*/  
virtual void Attach(Ix_Observer* observer) = 0;  
//! 去掉觀察者  
/*!  
\param observer 要去掉的觀察者  
\see Ix_Observer  
*/  
virtual bool Detach(Ix_Observer* observer) = 0;  
//! 改變時通知所有觀察者  
/*!  
\param data 通知參數(shù)，可為NULL  
*/  
virtual void Notify(void* data) = 0;  
};  
//! 二維點結(jié)構(gòu)  
struct POINT2D  
{  
double x; //!< X坐標(biāo)分量 D. 枚舉/結(jié)構(gòu)體/類的成員變量注視  
double y; //!< Y坐標(biāo)分量 在定義項右邊時加“<”，在其上面一行則不加  
};  
//! 觀察者的接口  
/*! \interface Ix_Observer  
*/  
struct Ix_Observer  
{  
//! 改變的通知  
/*!  
\param data 通知參數(shù)  
\param subject 發(fā)布改變通知的出版者,其他其他其他其他  
其他其他其他其他其他其他其他其他其他  
*/  
virtual void Update(void* data, const Ix_Subject* subject) = 0;  
}; 

一上就是對C++ Doxygen的相關(guān)操作的介紹。