package.html或package-info.java - Code

当尝试创建包级Javadoc注释时，首选的方法是什么?你会怎么做?

package-info.java

优点更新的缺点类的滥用——类是用于代码的，而不仅仅是用于注释的

package.html

优点 HTML扩展意味着它不是代码 IDE /文本编辑器中的语法高亮显示缺点没有一个吗?

对我来说，我一直使用Package.html。但我想知道这是否是正确的选择。

package-info.java:“这个文件是JDK 5.0中的新文件，比package.html更受欢迎。”- javadoc Java API文档生成器

附录:最大的区别似乎是包注释。在7.4包声明中有更多的基本原理。

附录:注释特性在这里和Javadoc提示:更喜欢package-info而不是package.html中也提到了。

附录:参见package-info.java的用途。

2010-09-05 02:09:16

aliyun