为什么Eclipse会生成两个注释块成一个包-info.java

Question

当我右键单击包 -> 新建 -> 包时，检查 "create package-info.java"，Eclipse 4.4.2 将包的模板 -info.java 放入该目录。那挺好的。它看起来像这样：

/**
 * 
 */
/**
 * @author John Doe
 *
 */
package name.of.pkg;

如您所见，有两块评论。我的问题是：上块的目的是什么？

我看不到它出现在生成的 JavaDoc 中的任何地方 HTML。只有下方评论区和作者上方的内容在输出中可见。两行中只有一个星号的行很吸引人，但在输出中不可见。到目前为止，我从未在任何关于 package-info.java 的博客或文档中看到过两个评论块。

Answer 1

顶部是许可协议。当您获得专业编程许可证时，让其他人知道他们可以在哪里、如何以及是否可以使用此代码变得非常重要。

常用语法是：

/**
 * LICENSE
 */

import java.util.*;

/**
 * JavaDoc about the class
 *
 * @author Your Name <yourname@yourdomain.com>
 */
public class ClassName {}

为什么Eclipse会生成两个注释块成一个包-info.java

Why does Eclipse generate two comment blocks into a package-info.java

java

eclipse

javadoc