单行注释、多行注释与文档注释

单行注释：// 注释内容

多行注释：/* 注释内容*/

文档注释：/** 注释内容 */ （它是java语言特有的注释，其中的注释内容能够被JDK提供的工具 javadoc 所解析，生成一套可以以网页形式体现程序的说明文档）

区别：多行注释不能够生成开发者文档，而文档注释能够生成开发者文档（文档分为使用者文档和开发者文档）。

注意规范点：

一、三种注释均可以出如今程序的任何地方，可是通常要有个规范的地方，不推介任意找位置。

二、单行注释通常写在语句的后面。

三、多行注释和文档注释通常写在语句的上面，文档注释只能出如今类、属性、方法的上面，不然提取不到。

四、多行注释中能够嵌套单行注释，多行注释中不能嵌套多行注释。

文档注释的使用（若是一个类想要使用javadoc工具生成开发者文档，那么这个类必须使用public修饰）：

在已经成功安装jdk并已经配置好path环境变量的前提下

一、使用dos命令

使用 javadoc 开发工具生成，在命令行下输入javadoc会有一些javadoc使用说明能够看到。咱们使用javadoc -d命令，使用格式：javadoc -d 存放路径 java源文件

二、eclipse

使用eclipse就没有这么些问题了，直接建立java类，而后Project-->Generate Javadoc，点击Generate Javadoc后，进入弹出的界面，选择javadoc.exe命令的位置，选择要生成Javadoc的包，或者包下的类，以及生成的Javadoc文档所存的路径，默认生成到当前工程目录下。以后会生成Javadoc文件:在生成文档的目录下会有一堆文件，找到index.html文件，打开查看具体的内容就ok。