Java文档注释

　　文档注释是用于生成API文档，API主要用于说明类、方法、成员变量

javadoc工具处理文档源文件在类、接口、方法、成员变量、构造器和内部类之前的注释，忽略其他地方的文档注释。而且javadoc工具默认只处理以public或protected修饰的类、接口、方法、成员变量、构造器和内部类之前的文档注释。
如果开发者希望javadoc工具可以提取private修饰的内容，则可以使用javadoc工具是增加-private选项

javadoc命令的基本用法如下：

  javadoc 选项 Java源文件|包

java源文件可以支持通配符：

　　如，使用*.java来代表当前路径下所有的java源文件。

javadoc 的常用选项：

 javadoc -d apidoc -windowtitle 测试 -doctitle 学习 javadoc 工具的测试 API 文档 -header 我的类*Test.java

javadoc标记：

上面的标记的使用有位置限制的。

出现在类或者接口文档注释中的有@see、@deprecated、@author、@version等

可以出现在方法或者构造器文档注释的有@see、@deprecated、@param、@return、@throws、和@exception等

可以出现在成员变量的文档注释中的有@see和@deprecated等

巴特西