1、javadoc的获取

只能从相应的jdk中取得，安装后在bin目录下。具体如下：

* javadoc 1.4 is included in java 2 sdk, standard edition v 1.4

* javadoc 1.3 is included in java 2 sdk, standard edition v 1.3

* javadoc 1.2 is included in java 2 sdk, standard edition v 1.2

* javadoc 1.1 is included in jdk 1.1

2、文档注释编写(principles)

java平台api文档由源码中的文档注释定义，且任何此类文档皆从此类注释取得

java平台api文档是调用者(caller)和实现之间的契约(contract)

除非另有说明，java平台api文档声明(assertion)应为与具体实现无关(implelementation-independent)

java平台api文档应有足够的声明，以使得软件质量保证部门能写出完全的jck (java compatibility kit)测试。

3、文档注释编写细则

每个文档注释的第一句，应是个概要句，简明但无遗地描述api项。第一句在第一个后跟空格的点号前结束。当句中出现非结束意义的点加空格时，需要空格进行转义，如 等。

自动重利用父类/接口方法（method）的注释，当（1）一个类方法重写(override)父类的方法时，或（2）一个接口方法重写父接口的方法时，或（3）一个类方法实现一个接口方法时。如果当前方法没文档注释，则从父方法复制，如果有，则不复制而是前两者有小标题 "overrides",后者有＂specified by＂.

用...来标注关键词或名字

节约使用行内链接{@link}

对方法和构建函数的说明，要去掉括号

可以为了简短使用短语而不是句子

使用第3人称而不是第2人称

以一个动词短语开始对一个方法的描述

对类/接口/字段(field)的描述，可以忽略主语

用"this"而不是＂the＂来引用从当前类生成的对象

不要仅是简单地把api名字里的单词展开来做描述，要增加一些信息。

当作用＂field＂一词时，注意它易引起混淆

避免拉丁语缩写

标签顺序

@author，多个作者时按参考修改代码的年代为序

@version

@param，多个参数时以方法声明中的顺序为序，单个@param后跟参数名（不要相应的类型），再加描述

@return

@exception，多个异常时以异常名字的字母顺序为序

@see，多个参见时据 #field,#constructor(type, type...),#constructor(type id, typeid...),#method(type, type,...),#method(type id, type, id...),class,class#field,class#constructor(type, type...),class#constructor(type id, type id),class#method(type, type,...),class#method(type id, type id,...),package.class,package.class#field,package.class#constructor(type, type...),package.class#constructor(type id, type id),package.class#method(type, type,...),package.class#method(type id, type, id),package排序

@since

@serial

@deprcated

＠param和@return(当返回不是void时)都是必须的．

（t007）