您的位置:首页 > 编程语言 > Java开发

如何将java程序中的文档注释提取出来生成说明文档

2010-03-23 23:15 447 查看
javadoc技术,是从源代码中抽取类,方法,成员等文档注释形成一个与源代码配套的API帮助文档,用一套特定的标签做注释,在编程结束后,通过javadoc.exe生成开发文档。
常用的3种注释语句:
//用于单行注释
/*......*/用于多行注释,不能嵌套
/**.......*/用于支持javadoc的特有的文档注释语句
javadoc能从java源文件中读取第三种方式的注释并识别一些特殊的变量
@auth 作者信息
@version 版本信息
@parameter 参数名和意义
@since 参数名和意义
@return 返回值
@throws 异常类和抛出条件
@deprecated 引起不推荐使用的警告
@see 交叉参数

执行过程
同编译java文件一样
用javadoc TestJavaDoc.java
即可生成html的说明文档。
Javadoc的格式如下:
javadoc 选项|软件包名|源文件|@file
@file指包含文件,为了简化操作,可以把需要的软件包名和源文件放在一个文件中
javadoc ―d mydoc test.1 test.2

可以用一个名称为myfile.txt的文件内容:
mydoc test.1
test.2
然后执行:javadoc ―d mydoc @myfile.txt

javadoc工具的详细说明可以用javadoc -help命令本文出自 “三人行必有我师” 博客,请务必保留此出处http://00liuxiaolong.blog.51cto.com/967387/287303
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: