java - 为什么 Eclipse 会在一个 package-info.java 中生成两个注释 block

Question

当我右键单击一个包 -> 新建 -> 包，选中“创建 package-info.java”时，Eclipse 4.4.2 将 package-info.java 的模板放入该目录。那挺好的。它看起来像这样:

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

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

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

Answer 1

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

常用语法是:

/**
 * LICENSE
 */

import java.util.*;

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