Doxys

今年对我的编程生涯来说简直是一个工具年。从MindMap工具MindManager，到UML工具DIA和Visio，都对我的coding方式有很大改善。眼看着年底将至，末世情结再现，这个节骨眼上，遇到了Doxys。

Doxys是一类被称为Documentation Extraction Tools的工具。它的工作原理其实很简单，就是在代码中有一些注释的约定，符合约定的注释可以直接被转换成html的文档。Doxys基于另一个DET项目Doxygen，不过我没试过那个，据说注释风格有些怪异。这是我目前看到的最好的代码维护工具。UML更多是用于理解代码，尤其是关键代码的，把所有的代码，尤其是例程，都UML出来很不现实。而且没有直接对应关系，要保持两个地方的逻辑一致，这才是维护的时候最难的地方。事实上，无论是MindMap工具，还是UML图，还是Word一类的RTF文档编辑器，都存在这个问题。从这个意义上说，Doxys是最好的方式。