[原] 外包工学JAVA--(2)

[原] 外包工学JAVA--(2)

注释的学习

Java程序有两类注释：实现注释(implementation comments)和文档注释(document comments)。

①　实现注释(implementation comments)：包括 单行注释"//" 和 多行注释"/*......*/"
    　用以注释代码或者实现细节。

②　文档注释(document comments)：Java独有的，由/**...*/界定
        用以描述Java的类、接口、构造器，方法，以及字段(field)。
        可以通过JAVADOC工具转换成HTML文件。

附：最简单的JAVADOC的使用

程序路径如图所示

"开始"-->"运行"-->"cmd",然后如下图输入


完成后就形成 文件下 doc目录

 参数说明 
 -d                    指定API文档的输出目录，默认是当前目录。建议总是指定该参数。
 -sourcepath     指定源代码路径，默认是当前目录。 此参数通常是必须的。
 -subpackages  以递归的方式处理各子包。关键参数！如果不使用本参数，每次只能处理一个子包（或需手工列出所有子包）。