Posted on 2007-10-22 16:47
G_G 閱讀(935)
評論(0) 編輯 收藏 所屬分類:
javaGeneral
1。項目中 ->Exprot.. -> @javadoc 就可以了
2。javadoc 命令學(xué)習(xí)
??? @author 作者
???
@see 另請參見
??? ??? （1）、@see "string" 為"string"添加文本項，不產(chǎn)生鏈接。
??? ??? （2）、@see <a href="URL#Value">Label</a> 使用HTML標(biāo)記產(chǎn)生鏈接
??? ??? （3）、@see package.class#member Label 使用Java語言的名字package.class #member產(chǎn)生鏈接。
@version 版
??? @since 從以下版本開
??? @param 參數(shù)說明
/** */中的開頭是注解
- ?? /**
?? */? 的就近原則 在那個上面就為那個注解
參照：http://java.ccidnet.com/art/3743/20031203/519697_1.html
/** class description
*/
3、Variable Description:描述變量的意義和取值含義。
/** var variable description
*/
4、Method Description:標(biāo)明每個方法的輸入、輸出參數(shù)和返回值類型，說明特殊變量取值的含義。相關(guān)類文檔鏈接。
/** method description
* @param var signification 方法參數(shù)說明
* @exception exception class name throws 說明
* @return return_value return signification return 說明
*/
5、Association Description:關(guān)聯(lián)類文檔描述，在注釋當(dāng)中需要參引其它文檔描述的地方，可在相應(yīng)的注釋當(dāng)中如下插入：
/** method description
* @param var signification
* @exception exception class name
* @return return_value return signification
* @see package.class#member label
*/
6、包描述文件：概括描述包的功能和設(shè)計概要。為每個包創(chuàng)建一個描述文件，命名為package.html，與包的java文件放在一起。
- ???