java ide中都自带有jdoc,可以自动为代码生成文档,vc怎么办?
最近找到两个工具,可以为vc代码生成文档。
一个VCExtend ,国内一个人编写的吧,效果不好,总出错。
一个Doxygen http://www.stack.nl/~dimitri/doxygen/
Doxygen is a documentation system for C++, C, Java, Objective-C, Python, IDL (Corba and Microsoft flavors) and to some extent PHP, C#, and D.
It can help you in three ways:
- It can generate an on-line documentation browser (in HTML) and/or an off-line reference manual (in ) from a set of documented source files. There is also support for generating output in RTF (MS-Word), PostScript, hyperlinked PDF, compressed HTML, and Unix man pages. The documentation is extracted directly from the sources, which makes it much easier to keep the documentation consistent with the source code.
- You can configure doxygen to extract the code structure from undocumented source files. This is very useful to quickly find your way in large source distributions. You can also visualize the relations between the various elements by means of include dependency graphs, inheritance diagrams, and collaboration diagrams, which are all generated automatically.
- You can even `abuse' doxygen for creating normal documentation (as I did for this manual).
Doxygen挺好用的,但是比起jdoc工具还是有差距