只要我们按照Javadoc 注释规则，在编码完成后，Javadoc 就能够帮我们从源代码中生成相应的Html 格式的API开发文档。这些文档可以通过Web浏览器来查看。点击Oracle规范，我根据SDK内源码的注释习惯，将常用的javadoc tag进行了整理，见下：

tags

在给公共类或公共方法添加注释的时候，第一句话应该是一个简短的摘要。注意左侧不要紧挨 * 号，要有一个空格。如果注释有多个段落，使用< p>段落标记来分隔段落。我们还可使用< tt>标签来让特定的内容呈现出等宽的文本效果。见下：

    
    public void test(){}

如果注释描述里需要包含一个列表，一组选项等，我们可以使用< li>标签来标识，注意标签后不需要空格，见下：

    
    public void test(){}

@param 是用来描述方法的输入参数。注意在方法描述和tag 之间需要插入空白注释行。不需要每个参数param的描述都对齐，但要保证同个param的多行描述对齐。param 的描述不需要在句尾加标点。

    
    public void test(String builderTest, boolean isTest){}

@return 是用来描述方法的返回值。要写在@param tag之后，与其他tag 之间不需要换行。@throws 是对方法可能会抛出的异常来进行说明的，通常格式为：异常类名+异常在方法中出现的原因。见下：

    
    public int test(int capacity){
        if (capacity < 0)
            throw new IllegalArgumentException("Illegal initial capacity");
        return capacity;
    }

@deprecated 用于指出一些旧特性已由改进的新特性所取代，建议用户不要再使用旧特性。常与@link 配合，当然@link的使用位置没有任何限制，当我们的描述需要涉及到其他类或方法时，我们就可以使用@link啦，javadoc会帮我们生成超链接：

    
    public void test(boolean isTest){}

@link 常见形式见下:

@code 用来标记一小段等宽字体，也可以用来标记某个类或方法，但不会生成超链接。常与@link配合，首次通过@link生成超链接，之后通过@code 呈现等宽字体。

    
    public void test(boolean isTest){}

@see 用来引用其它类的文档，相当于超链接，javadoc会在其生成的HTML文件中，将@see标签链到其他的文档上：

    
    public int test(int capacity){
        if (capacity < 0)
            throw new IllegalArgumentException("Illegal initial capacity");
        return capacity;
    }

@see形式与@link类似，见下：

@since 用来指定方法或类最早使用的版本。在标记类时，常与@version和@author配合，一个用来指定当前版本和版本的说明信息，一个用来指定编写类的作者和联系信息等。我们也可以通过< pre>来添加一段代码示例。见下：

    
    public class Test<T extends Test2> {
        
        public int test2(int capacity) {
            return capacity;
        }
    }

@inheritDoc 用来从当前这个类的最直接的基类中继承相关文档到当前的文档注释中。如下的test() 方法，会直接继承该类的直接父类的test()方法注释。注意与其他tag 不需要插入空行：

    
    public void test(boolean isTest){}

@docRoot 它总是指向文档的根目录，表示从任何生成的页面到生成的文档根目录的相对路径。例如我们可以在每个生成的文档页面都加上版权链接，假设我们的版权页面copyright.html 在根目录下：

    
    public class Test {}