Javadoc标签和Javadoc注释规范说明

// 注释一行
/ *  */ 注释若干行 
/**  ……*/ 注释若干行，写入Javadoc文档

生成文档是HTML格式。
换行<br>
分段<p>(写在段前）)

/** 
* show 方法的简述.
* <p>show 方法的详细说明第一行<br> 
* show 方法的详细说明第二行 
* @param b true 表示显示，false 表示隐藏 
* @return 没有返回值 
*/ 
public void show(boolean b) {
  frame.show(b);
  } 

<span style="font-size:18px;">*/
/**javadoc注释的内容
*/
public class Hello{
  /**属性上的注释*/
  public String name;
  /**这是main方法,是程序的入口
  *@param args 用户输入参数
  */
  public static void main(String[] args){
 System.out.println("Hello World!");
    f1();
  }
  /** 这是第1个方法,其作用是...*/
  public static void f1(){
   System.out.println("f1()！");
  }
}</span>

<span style="font-size:18px;">import java.io.IOException;
/**javadoc注释内容
*@since 1.0
*@version 1.1
*@author Blue Jey
*<br>链接到另一个文档{@link Hello},就这些
*see Hello
*/
public class HelloWorld{
 /**非public，protected 属性上的注释不生成*/
 public String name;
 /**这是main方法，是程序的入口
 *@param args 用户输入的参数，是数组
 *@throws IOException main方法io异常
 */
 public static void main(String args[]) throws IOException{
 System.out.println("hello World!");
 
 f1();
 f2(1);
 }
 /**这是第一个方法，其作用是....
 *@deprecated 从版本1.2开始，不再建议使用此方法
 */
 public static void f1(){
 System.out.println("fl()!");
 }
 /**这是第二个方法，其作用是....
 *@return 返回是否OK
 *@param i 输入参数i
 *@see Hello
 *@throws IOException io异常
 */
 public static String f2(int i)throws IOException{
 System.out.println("f1()!");
 return "OK";
 }
 } </span>

javadoc -version -author -d doc *.java