Posted on 2007-10-22 16:47
G_G 閱讀(934)
評(píng)論(0) 編輯 收藏 所屬分類:
javaGeneral
1。項(xiàng)目中 ->Exprot.. -> @javadoc 就可以了
2。javadoc 命令學(xué)習(xí)
??? @author 作者
???
@see 另請(qǐng)參見
??? ??? (1)、@see "string" 為"string"添加文本項(xiàng),不產(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ù)說明
/** */中的開頭是注解
- ?? /**
?? */? 的就近原則 在那個(gè)上面就為那個(gè)注解
參照:http://java.ccidnet.com/art/3743/20031203/519697_1.html
/** class description
*/
3、Variable Description:描述變量的意義和取值含義。
/** var variable description
*/
4、Method Description:標(biāo)明每個(gè)方法的輸入、輸出參數(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è)計(jì)概要。為每個(gè)包創(chuàng)建一個(gè)描述文件,命名為package.html,與包的java文件放在一起。
- ???