JBuilder2005创建开发文档之创建文档

JBuilder2005创建开发文档之创建文档2010-03-27陈雄华虽然在Java文件中编写注释后，马上可以切换到内容窗格的Doc视图页代码中对应的Javadoc文档，但在Doc视图页中生成的文档仅是不完整的"范本"。首先，没有导航树，其次没有生成通过@see或@link关联内容的链接。所以你可以把Doc视图页中的Javadoc文档看成是Javadoc最终版本的预览。

要为工程产生完整的Javadoc文档，必须通过Javadoc向导，在这节里，我们用Javadoc向导为javadoc工程创建完整的Javadoc文档。

1．File->New...->Build->双击Javadoc图标，弹出创建Javadoc的向导，如下图所示：

图 23 选择可用的doclet

Doclet name中包含了两个选项，分别是Standard Doclet和JDK 1.1 Doclet。Standard Doclet将采用JDK 1.3以上的格式创建Javadoc文档，如果选用JDK 1.1 Doclet，许多设置选项将无法使用。

这里，我们接受默认的Standard Doclet选项，按Next到下一步。

注意：

JDK 1.4和JDK5.0并未提供对JDK 1.1 Doclet的支持，所以如果你的工程的JDK是JDK 1.4或JDK5.0，当你选用JDK 1.1 Doclet创建Javadoc文档时，你将得到以下的错误信息：

JDK 1.1 Doclet: Cannot find doclet com.sun.tools.doclets.oneone.OneOne

on the class path. Check available in JDK configured to be used.

2．指定Javadoc节点名和创建选项

图 24 指定节点名及创建选项

·Name：Stand Doclet，在完成这个向导后，在工程窗格资源树中会创建一个节点，表示工程的Javadoc文档，这里设置的就是节点的名字。

·Output directory：D:/javadoc/doc，Javadoc文件的输出目录。接受这个默认的设置。