在《thinking in java》一书的第一章提到javadoc，以前也看过，每次看到这部就跳过了，没有真正去尝试过什么样子，今天终于亲自实践了一下，原来真的挺简单：
一、编写java源文件

package com.cn.ibm.javadocTestPac;

/**

 * @author Karen

 * @see HelloWorld

 * @version 4.0

 */

public class JavadocTestClass {

    /**

     * @param args

     */

    public static void main(String[] args) {

        // TODO Auto-generated method stub

        System.out.println("javadocTestClass");

    }

}

二、

使用eclipse生成文档（javadoc）

主要有三种方法： 
1，在项目列表中按右键，选择Export（导出），然后在Export(导出)对话框中选择java下的javadoc，提交到下一步。 
在Javadoc Generation对话框中有两个地方要注意的： 
javadoc command:应该选择jdk的bin/javadoc.exe 
destination:为生成文档的保存路径，可*选择。 
按finish(完成)提交即可开始生成文档。 
2，用菜单选择：File->Export(文件－>导出)， 
剩下的步骤和第一种方法是一样的。 
3，选中要生成文档的项目，然后用菜单选择， 
Project->Generate Javadoc直接进入Javadoc Generation对话框，剩余的步骤就和第一种方法在Javadoc Generation对话框开始是一样的。

三、结果：生成一个按包目录的一些文件夹，并且生成JavadocTestClass.html等其他html文件

小结：使用javadoc主要还是靠自己在java源文件当中添加注释（这些注释要按照javadoc的规范书写），注释按规范写好了之后，并且用eclipse中自带的功能生产一个html文档，里面就有所注释所在类的详细信息。