设为首页 加入收藏

TOP

JBuilder2005创建开发文档之创建文档
2014-11-23 19:53:38 】 浏览:1099
Tags:JBuilder2005 创建 开发 文档

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


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


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


  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节点名和创建选项


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


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


  ·4个创建选项。


  * Show console output:在创建Javadoc文档时,在信息窗格中显示出创建文档的报告信息,在默认情况下,这个选项没有勾选,我们将其选中,以便在创建文档时,看到各种报告信息,如下图所示:


  * Always run Javadoc When building the project:设置是否需要在Rebuild工程时,创建Javadoc文档。在默认情况上这个选项是勾选的,由于每次Rebuild工程时,都会连带编译并产生工程的Javadoc文档,这将浪费较多的时间。你大可在需要创建Javadoc文档时,通过资源树的Javadoc节点手工来创建它。所以我们去除这个选项设置。


  * Use project JDK when running Javadoc:勾选这个设置项中,JBuilder将用工程所用的JDK所带的Doclet来创建Javadoc文档,否则使用JBuilder自带的JDK1.4所带的Doclet。


  * Include project test path directory:用JUnit测试框架生成的测试类,将统一放在工程目录的test子目录下。选择该设置项后,测试类的Javadoc文档将和工程其他类的文档一起输出。在一般情况下,这并不是我们所希望的,所以去除这个选项。


  按Next到下一步。


】【打印繁体】【投稿】【收藏】 【推荐】【举报】【评论】 【关闭】 【返回顶部
上一篇JBuilder2005创建开发文档之标签.. 下一篇Eclipse远程调试Weblogic运行的源..

最新文章

热门文章

Hot 文章

Python

C 语言

C++基础

大数据基础

linux编程基础

C/C++面试题目