爲什麼Eclipse在package-info.java中生成兩個註釋塊

Question

當我右鍵單擊包 - > new - >包時，請檢查「create package-info.java」，Eclipse 4.4.2將一個模板將package-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 {}