javadoc

javadoc是Sun公司提供的一個技術，它從程序源代碼中抽取類、方法、成員等註釋形成一個和源代碼配套的API幫助文檔。也就是說，只要在編寫程序時以一套特定的標籤作註釋，在程序編寫完成後，通過Javadoc就可以同時形成程序的開發文檔了。

javadoc命令是用來生成自己API文檔的，使用方式：使用命令行在目標文件所在目錄輸入javadoc +文件名.java。

標籤	說明	JDK 1.1 doclet	標準doclet	標籤類型
@author 作者	作者標識	√	√	包、類、介面
@version 版本號	版本號	√	√	包、類、介面
@param 參數名描述	方法的入參名及描述信息，如入參有特別要求，可在此註釋。	√	√	構造函數、方法
@return 描述	對函數返回值的註釋	√	√	方法
@deprecated 過期文本	標識隨著程序版本的提升，當前API已經過期，僅為了保證兼容性依然存在，以此告之開發者不應再用這個API。	√	√	包、類、介面、值域、構造函數、方法
@throws異常類名	構造函數或方法所會拋出的異常。		√	構造函數、方法
@exception 異常類名	同@throws。	√	√	構造函數、方法
@see 引用	查看相關內容，如類、方法、變數等。	√	√	包、類、介面、值域、構造函數、方法
@since 描述文本	API在什麼程序的什麼版本后開發支持。	√	√	包、類、介面、值域、構造函數、方法
{@link包。類#成員標籤}	鏈接到某個特定的成員對應的文檔中。		√	包、類、介面、值域、構造函數、方法
{@value}	當對常量進行註釋時，如果想將其值包含在文檔中，則通過該標籤來引用常量的值。		√(JDK1.4)	靜態值域