Java文档注释
文档注释是用于生成API文档，API主要用于说明类、方法、成员变量
- javadoc工具 处理文档源文件在类、接口、方法、成员变量、构造器和内部类之前的注释，忽略其他地方的文档注释。而且javadoc工具默认只处理以public或protected修饰的类、接口、方法、成员变量、构造器和内部类之前的文档注释。
- 如果开发者希望javadoc工具可以提取private修饰的内容，则可以使用javadoc工具是增加-private选项
javadoc命令的基本用法如下：
javadoc 选项 Java源文件|包
java源文件可以支持通配符：
如，使用*.java来代表当前路径下所有的java源文件。
javadoc 的常用选项：
- -d<directory>: 该选项指定一个路径，用于生成的API文档存放到的指定目录下。
- -windowtitle<text>: 该选项指定一个字符串，用于设置API文档的浏览器窗口标题。
- -doctitle<html-code>:该选项指定一个HTML格式文本，用于指定概述页面的标题。 只有处于当个包下的源文件来生成API文档时，才有概述页面。
- -header<html-code>:该选项指定一个HTML格式的文本，包含么个页面的页眉。
javadoc -d apidoc -windowtitle 测试 -doctitle 学习 javadoc 工具的测试 API 文档 -header 我的类*Test.java
javadoc标记：
- @author: 指定Java程序的作者。
- @version:指定源文件的版本。
- @deprecated:不推荐使用的方法。
- @param: 方法的参数说明。
- @return: 方法的返回值说明信息。
- @see: "参见“，用于指定交叉参考的内容。
- @exception: 抛出的异常的类型。
- @throws: 抛出的异常，和@exception同义。
上面的标记的使用有位置限制的。
出现在类或者接口文档注释中的有@see、@deprecated、@author、@version等
可以出现在方法或者构造器文档注释的有@see、@deprecated、@param、@return、@throws、和@exception等
可以出现在成员变量的文档注释中的有@see和@deprecated等
