1. java的注释
Java里有两种注释风格。下面这个写法是非常常见的
/*This is a comment *that continues *across lines */
还可以写成：
/*This is a comment that continues across lines*/
第二种写法如下：
//This is one-line comment
2. Java的嵌入式文档
通常，我们把注释和代码都放到了同一个文件example.java里面，这是为了更好地维护Java文件的注释，因为如果说明文档和源代码分开的话，每次修改源代码之后，还要费力气去维护说明文档API。如果都写在一起，修改的同时，就可以一起维护了。
注释和源代码一起看有时候会比较繁琐，所以，JDK提供了给我们一个提取注释的工具javadoc。这个是能够在Java文件里面提取对应的注释，并且生成HTML文档，以供我们查阅的，非常方便。
那么，我们用eclipse怎么样提取javadoc呢，其实，就在eclipse的project里面就能够自动提取javadoc了。project → Generate javadoc
而javadoc的一些标签，可以使我们在注释文档和生成文档API的时候显得更加的专业，那么，具体的标签有什么呢？请参照下面的表格,查看常用的javadoc：
