Posted on 2009-08-28 17:14
Fox 閱讀(2925)
評論(5) 編輯 收藏 引用 所屬分類:
T技術(shù)碎語
本文同步自游戲人生
我發(fā)現(xiàn)我最近成了Cygwin下的小白鼠，寫完Cygwin下安裝ACE，寫ACE在cygwin下的使用。現(xiàn)在又寫doxygen。
之前提到在Cygwin下讀代碼的不習(xí)慣，后來回到VS下看。沒過幾天，覺得VS下還是不夠直觀，于是就直接看ACE的doxygen了……
doxygen好是好，用起來還是要慢慢習(xí)慣才行，需要在寫注釋和代碼的時候注意一些，掌握的細(xì)節(jié)和技巧越多，出來的文檔越豐富（當(dāng)然，這和代碼質(zhì)量是兩碼事）。
我自然是把doxygen安裝在Cygwin下了，由于doxygen沒有提供info，Info doxygen時就自動打開了doxygen的man，和man doxygen、doxygen --help一個效果。
如果希望閱讀更詳盡的使用方法，只有自己down一個manual了。
在Cygwin下，doxygen采用GNU的libiconv進行文字編碼的轉(zhuǎn)換，以UTF-8作為默認(rèn)編碼。
使用doxygen生成config-file模板后，可以在config-file中進行一些項目設(shè)置（有注釋的，看的懂）。
為了支持中文，我DOXYFILE_ENCODING用的是EUC-CN，但輸出文檔的語言O(shè)UTPUT_LANGUAGE卻選了English。兩點原因：
o EUC-CN（各種漢字編碼知識就不在此普及了，你可以認(rèn)為簡體字編碼都是EUC-CN）和UTF-8不同，但OUTPUT_LANGUAGE的各種語言都是使用的UTF-8，所以兩種編碼不可能同時顯示，當(dāng)然，你可以把EUC-CN全轉(zhuǎn)成UTF-8。編碼不是高級的技術(shù)，但對于非英語用戶絕對是一個噩夢，后來發(fā)現(xiàn)是我自己學(xué)藝不精，DOXYFILE_ENCODING只是配置文件的編碼格式而已，而識別中文文檔只需要修改INPUT_ENCODING成EUC-CN即可，OUTPUT_LANGUAGE自然設(shè)置成Chinese也不會有問題，因為doxygen采用UTF-8輸出，使用中文輸出不會有亂碼問題。
o 雖然我的英文很蹩腳，雖然我的文檔中多有中文注釋。但像doxygen中文輸出的文檔中把class、public都給你翻譯成中文，你也受不了，這也英文水平無關(guān)。
config-file中的其他內(nèi)容我現(xiàn)在也用不到，就沒有仔細(xì)看。
因為Kevin會在公司里講一下doxygen，doxygen的manual也講的很詳細(xì)，我就省點時間，不翻譯文檔了。
簡單的一個Doxygen的測試在這里。