我可以使用Eclipse轻松地将JavaDoc添加到包中吗？

我使用javadoc来logging我的类和方法。 我想向我的软件包添加一些概述信息。 我喜欢Eclipse如何为每个类或方法创build一个匹配的文档注释的存根（stub），一旦我键入/**<Enter> 。 Eclipse是否也有一个简单的方法来生成package.html文件 ？

Answer 1

4年后更新（2013年10月）

javabeangrinder的答案 （upvoted）提到了下面的技巧：

要在现有包中创buildpackage-info.java文件，请执行以下操作：

• 右键单击你想要package-info.java的包。
• selectnew->package 。
• 选中Create package.info.javacheckbox。
• 点击Finish

---

原文答复（2009年5月）

没有模板或向导来轻松创buildpackage.html文件。

正如Java1.5在评论中所说的那样，自Java1.5以来，创build的正确文件将是package-info.java 。
该文件不仅可以用于javadoc，也可以用于包级别的注释 （如图所示 ）。

有一个打开的Bug（＃86168）要求向导创buildpackage-info.java （因为类向导不允许package-info名称 ）。

关于这个话题的思考是从2005年开始的！ 问题是任何解决scheme都应该以对1.4代码有帮助的方式来实现。

目前的解决方法是创build一个package-info.java作为text文件。
从这一点开始， package-info.java就像普通的Java类一样工作，Eclipse将一个package-info.class文件放在输出文件夹中。
Javadocs使用package-info.java正确构build，而不是package.html文件。

替代文字http://jmdoudoux.developpez.com/cours/developpons/javahttp://img.dovov.comjaxb006.png

---

注意（回应草莓的评论）：

• 缺陷77451 （2004 !,对于package.html）
• bug 163633和bug 163926 （2006，对于package-info.java）

都希望 在Javadoc视图中预览Package-info.java中的包概览 。

到目前为止，没有补丁已经提出/实施。
没有足够的要求来添加该function。

Answer 2

在日食

由于package-info.java不是类的有效标识符，因此不能在Eclipse中将其创build为类。

我发现当你创build一个新的包时，会出现一个checkbox来检查你是否需要一个package-info.java。

要在现有包中创buildpackage-info.java文件，请执行以下操作：

1. 右键单击你想要package-info.java的包。
2. select新build – >包。
3. 选中Create package.info.javacheckbox。
4. 点击完成

Answer 3

JAutodoc插件在这方面做得非常好，以及您所有的其他文档需求。 安装并configuration插件并右键单击包，然后单击JAutodoc> Add Package Javadoc

有一些configuration和模板可用于.java或.html包文档。

这个插件也做了很大的工作，标准化了所有的Javadoc需求，并进行了大量的定制。

http://jautodoc.sourceforge.net/

Answer 4

有一个插件，似乎创buildpackage.html文件。 我没有使用它，但有人在这里登陆可能会发现它有用。

http://sourceforge.net/projects/package-javadoc/