JavaDoc生成doc

Java 如何将程序中的注释提取出来生成说明文档
第一种方法：

可以使用JavaDoc工具。它可以从程序源码中将类、方法、成员变量等文档注释抽取出来形成一个与源代码配套的API帮助文档。但是在编写代码时要以一定的规范做注释才可以。通过JavaDoc实现工具就可以同时生成代码的开发文档了。JavaDoc工具位于 C:\Program Files\Java\jdk1.6.0_10\bin 路径下。

其中/**...*/这种注释用于支持JavaDoc工具，还有一些以@开头的标识信息也可以抽取出来，如下图。


[img]http://dl2.iteye.com/upload/attachment/0100/8516/b44636ff-79a9-3655-9949-4e7c1aac3b25.jpg[/img]

这里使用源码中StringBuffer.java 文件为例。

打开控制台窗口，首先进入StringBuffer.java的目录，这里放在c盘test目录下。

执行javadoc StringBuffer.java

如下图

[img]http://dl2.iteye.com/upload/attachment/0100/8519/690337fb-9668-375c-b5d4-cba13da534b6.jpg[/img]

如果报无法找到命令，请确认安装JDK时是否配置了环境变量。



生成的文件如下。


[img]http://dl2.iteye.com/upload/attachment/0100/8522/de80fbad-8e08-3913-ae33-64870e3caa1f.jpg[/img]


打开文件就会看到类似于Java API样式的说明文档。



第二种方式：

借助eclipse实现。

在项目列表中按右键，选择Export，
然后在Export对话框中选择java下的javadoc，下一步。
在Javadoc Generation对话框中：
javadoc command:应该选择jdk bin 目录下的javadoc.exe
destination:为生成文