Eclipse中生成JavaDoc-hst_gogogo

1、首先编写Javadoc注释,(最好是在项目开发过程中就写好),注意Javadoc注释写法为:  /** 注释内容 */   (跟java注释/* 注释内容*/ 是不一样的,而且颜色也不同)

2、project->Generate Javadoc...(如果没有看到,就在Properties那里搜索,然后再点击project就可以看到了)

3、Javadoc command 选择你电脑上JDK 的bin目录下的 javadoc.exe,然后勾选你要生成Javadoc的工程,选择public(要生成所有,则选择private),然后选择生成位置,如果默认,则会在生成Javadoc 之后在你的工程目录下会出现一个doc目录,我是在桌面新建一个文件夹,然后再该目录下生成,next

4.选中Document title复选框,并命名,next

5.选择JDK版本,根据你自己的JDK来选,finish,然后可以在控制台看到输出生成javadoc的信息

显然,是出错了,错误信息:“ 错误:编码BGK的不可映射字符“,并且出现乱码

解决方法:重新生成,并在下图这一步输入“-encoding UTF-8 -charset UTF-8” 然后再生成

之后,我还遇到了“没有 @return”和 "return 没有内容"的警告(记不大清了,差不多是这样意思),这是由于注释方式不规范,在警告对应的方法那里加上 @return 并在后面加上相关注释内容即可,如下图(我也是首次写,可能内容写的不是很规范)

然后再生成的时候,控制台没有报错,也没有警告

在我桌面usersysforjavadoc(自己创建的一个空目录)中就出现了生成的javadoc文档

双击index.html (如果你电脑上有浏览器^_^),可以看到自己项目的API 文档就生成啦

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值