接触Doxygen后,认识到其强大之处,一口气将之前的烂代码重构了一遍,所有的文件头,函数注释等等都是手动添加注释。在keil中可以看到其对JavaDoc风格的注释有高亮,非常好看。但是keil这个IDE作为编译器和调试工具,好用的没话说,作为编辑器却非常不能与时俱进。自动补全,代码缩进都超烂。找了很多编辑器,像sublime,Atom,VS code等,又缺少跨文件的补全,go to definition等功能。vim和emacs学习曲线又太长。同事提到可以试试Qt Creator看看,于是我们一起试了试。发现真的可行。另外还有惊喜,就是发现Qt对Doxygen的支持非常好。
首先,提供了doxygen注释的高亮,如下图:
然后,我想到我还有一堆代码要重构,不想一点一点的添加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/。