欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

eclipse中自动生成javadoc文档的方法

程序员文章站 2024-03-02 14:10:40
本文实例讲述了eclipse中自动生成javadoc文档的方法。分享给大家供大家参考。具体方法如下: 使用eclipse生成文档(javadoc)主要有三种方法: 1....

本文实例讲述了eclipse中自动生成javadoc文档的方法。分享给大家供大家参考。具体方法如下:

使用eclipse生成文档(javadoc)主要有三种方法:

1. 在项目列表中按右键,选择export(导出),然后在export(导出)对话框中选择java下的javadoc,提交到下一步。
在javadoc generation对话框中有两个地方要注意的:
javadoc command:应该选择jdk的bin/javadoc.exe
destination:为生成文档的保存路径,可*选择。
按finish(完成)提交即可开始生成文档。

2. 用菜单选择:file->export(文件->导出),
剩下的步骤和第一种方法是一样的。

3. 选中要生成文档的项目,然后用菜单选择,
project->generate javadoc直接进入javadoc generation对话框,剩余的步骤就和第一种方法在javadoc generation对话框开始是一样的。
 
用哪种方法都行,但是要注意一下几个问题:

1、eclipse不能生成,报错:
java.lang.illegalargumentexception at sun.net.www.parseutil.decode 
,这是由于设置java环境变量引起的。例如classpath为
.;%java_home\lib\dt.jar;%java_home%\lib\tool.jar,解决方法就是把classpath删除或是参考官方文档 http://maven.apache.org/plugins/maven-javadoc-plugin/faq.html 。

2、生成文档乱码问题。完善api-doc,用eclipse生成javadoc的时候发生“编码 gbk 的不可映射字符 ”其实是字符编码问题。打开eclipse,project -> generate javadoc 一项一项的选你要输出javadoc的项目,最后一步中vm设置行中加入以下代码

复制代码 代码如下:
-encoding utf-8 -charset utf-8

希望本文所述对大家的java程序设计有所帮助。