本文同步自游戲人生

我發(fā)現(xiàn)我最近成了Cygwin下的小白鼠，寫完Cygwin下安裝ACE，寫ACE在cygwin下的使用。現(xiàn)在又寫doxygen。

之前提到在Cygwin下讀代碼的不習(xí)慣，后來回到VS下看。沒過幾天，覺得VS下還是不夠直觀，于是就直接看ACE的doxygen了……

doxygen好是好，用起來還是要慢慢習(xí)慣才行，需要在寫注釋和代碼的時(shí)候注意一些，掌握的細(xì)節(jié)和技巧越多，出來的文檔越豐富（當(dāng)然，這和代碼質(zhì)量是兩碼事）。

我自然是把doxygen安裝在Cygwin下了，由于doxygen沒有提供info，Info doxygen時(shí)就自動(dòng)打開了doxygen的man，和man doxygen、doxygen --help一個(gè)效果。

如果希望閱讀更詳盡的使用方法，只有自己down一個(gè)manual了。

在Cygwin下，doxygen采用GNU的libiconv進(jìn)行文字編碼的轉(zhuǎn)換，以UTF-8作為默認(rèn)編碼。

使用doxygen生成config-file模板后，可以在config-file中進(jìn)行一些項(xiàng)目設(shè)置（有注釋的，看的懂）。

為了支持中文，我DOXYFILE_ENCODING用的是EUC-CN，但輸出文檔的語言O(shè)UTPUT_LANGUAGE卻選了English。兩點(diǎn)原因：

o EUC-CN（各種漢字編碼知識(shí)就不在此普及了，你可以認(rèn)為簡體字編碼都是EUC-CN）和UTF-8不同，但OUTPUT_LANGUAGE的各種語言都是使用的UTF-8，所以兩種編碼不可能同時(shí)顯示，當(dāng)然，你可以把EUC-CN全轉(zhuǎn)成UTF-8。編碼不是高級(jí)的技術(shù)，但對(duì)于非英語用戶絕對(duì)是一個(gè)噩夢，后來發(fā)現(xiàn)是我自己學(xué)藝不精，DOXYFILE_ENCODING只是配置文件的編碼格式而已，而識(shí)別中文文檔只需要修改INPUT_ENCODING成EUC-CN即可，OUTPUT_LANGUAGE自然設(shè)置成Chinese也不會(huì)有問題，因?yàn)閐oxygen采用UTF-8輸出，使用中文輸出不會(huì)有亂碼問題。

o 雖然我的英文很蹩腳，雖然我的文檔中多有中文注釋。但像doxygen中文輸出的文檔中把class、public都給你翻譯成中文，你也受不了，這也英文水平無關(guān)。

config-file中的其他內(nèi)容我現(xiàn)在也用不到，就沒有仔細(xì)看。

因?yàn)?a href="http://www.shnenglu.com/kevinlynx/" target="_blank">Kevin會(huì)在公司里講一下doxygen，doxygen的manual也講的很詳細(xì)，我就省點(diǎn)時(shí)間，不翻譯文檔了。

簡單的一個(gè)Doxygen的測試在這里。