注释的学习
Java程序有两类注释:实现注释(implementation comments)和文档注释(document comments)。
① 实现注释(implementation comments):包括 单行注释"//" 和 多行注释"/*......*/"
用以注释代码或者实现细节。
② 文档注释(document comments):Java独有的,由/**...*/界定
用以描述Java的类、接口、构造器,方法,以及字段(field)。
可以通过JAVADOC工具转换成HTML文件。 附:最简单的JAVADOC的使用
程序路径如图所示
"开始"-->"运行"-->"cmd",然后如下图输入
完成后就形成 文件下 doc目录 参数说明 -d 指定API文档的输出目录,默认是当前目录。建议总是指定该参数。
-sourcepath 指定源代码路径,默认是当前目录。 此参数通常是必须的。
-subpackages 以递归的方式处理各子包。关键参数!如果不使用本参数,每次只能处理一个子包(或需手工列出所有子包)。