接觸Doxygen后,認識到其強大之處,一口氣將之前的爛代碼重構了一遍,所有的文件頭,函數注釋等等都是手動添加注釋。在keil中可以看到其對JavaDoc風格的注釋有高亮,非常好看。但是keil這個IDE作為編譯器和調試工具,好用的沒話說,作為編輯器卻非常不能與時俱進。自動補全,代碼縮進都超爛。找了很多編輯器,像sublime,Atom,VS code等,又缺少跨文件的補全,go to definition等功能。vim和emacs學習曲線又太長。同事提到可以試試Qt Creator看看,於是我們一起試了試。發現真的可行。另外還有驚喜,就是發現Qt對Doxygen的支持非常好。
首先,Qt提供了doxygen注釋的高亮,如下圖:
然后,我還有一堆代碼要重構,一點點添加注釋實在太費時間,就想有沒有自動化的方法。最開始想到的是使用Qt Creator的片段功能。
后來在翻設置選項時,又發現了這個
Qt Creator自帶了一個 doxgen注釋功能。於是百度之,發現了有一個自動添加 doxygen注釋的插件(http://dev.kofee.org/projects/qtcreator-doxygen/)。可是插件在3.1版本后就不再更新了,我用的是3.5版本。這么好的插件怎么可能就不更新了呢?於是繼續查找,發現了這個(http://wiki.qt.io/Doxygen_Plugin_for_QtCreator)
大概意思是,若是沒有插件的二進制檔,那么就得下載Qt Creator的源碼和插件源碼自己編譯了。怎么弄,我又參考了另外一篇文章,http://www.devbean.net/2011/08/qtcreator-plugin-develop-2/。
不過目前還沒有編譯成功。