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命令