■方法注释
紧靠在每条方法注释的前面，必须有一个它所描述的那个方法的签名。同样除了使用常规用途的标记以外，还可以使用如下针对方法的注释：
◇ @param 变量描述
当前方法需要的所有参数，都需要用这个标记进行解释，并且这些标记都应该放在一起。具体的描述（说明）可同时跨越多行，并且可以使用html标记。
◇ @return 该方法的返回值
这个标记为当前方法增加一个返回值（“Returns”）小节。同样具体描述支持html并可跨多行。
◇ @throws 该方法抛出的异常
这个标记为当前方法在“Throws”小节添加一个条目，并会自动创建一个超级链接。具体的描述可以跨越多行，同样可以包括html标记。一个方法的所有throws都必须放在一起。
下面是一个方法注释的例子：
|
■包和综述注释
前面的都是针对某一个类、方法等的注释，可以直接放在JAVA源文件中。然而为了生成一个包的注释，必须在每个包的目录下放置一个名为package.html的文件来对包进行描述。标签<body>....</body>之间的文字都会被javadoc自动提取出来。
也可以为所有源文件提供一个综述注释，写入名为overview.html文件中，将其放在所有源文件所在的父目录下面。标签<body> .... </body>之间的文字也都会被javadoc自动提取出来，做成文档的Overview
【如何提取程序文档】
首先，我们还是依照惯例来看看javadoc的基本用法，你可以通过javadoc -help来获得它当前版本的具体设定细节。
|
参数可以按造任意顺序排列。
· options 命令行选项。
· packagenames 一系列包的名字，空格分隔，必须分别制定想要为之建立文档的每一个包。Javadoc不递归作用于每一个包，也不允许使用通配符。
· sourcefiles 一系列源文件名，用空格分隔。源文件名可以包括路径和通配符如“*”。
· @files 以任意次序包含包名和源文件的一个或者多个文件。当在sourcefiles中需要指定的文件太多的时候，就可以使用它来简化操作。目标文件是以空格或者回车来进行分隔的源文件名。
其中常用的选项有：
-d 路径
指定javadoc保存生成的HTML文件的目的目录，缺省为当前目录。
-author
在文档中包含作者信息（默认情况下会被省略）
-version
在文档中包含版本信息（在默认情况下会被省略）
-header header文本
指定放置在每个输出文件顶部的页眉文件。该页眉文件将放在上部导航栏的右边，header文本可以包括HTML标记和空格，但是如果这样就必须用引号将它括起。在header中的任何内部引号都不许使用转义。
-footer footer文本
指定放置在每个输出文件底部的脚注文本。脚本将放置在下部导航栏的右边，其它同header一样。
-bottom text
指定放置在么个输出文件底部的文本。该文本将放置在页底，位于导航栏的下面。其它同header参数。
-protected
只显示受保护的和共有的类及成员，这是缺省状态。
-public
只显示公有的类和成员。
-package
只显示包、受保护的和公有的类及成员。
-private
显示所有的类和成员，如果是内部开发使用的程序文档，这个将非常有用。
-sourcepath sourcepathlist
当将包名传递给javadoc的时候，可以指定查找源文件（.java）的搜索路径。但必须注意，只有当用javadoc命令指定包名时才能使用sourcepath选项。如果省略sourcepath，则javadoc使用classpath查找源文件。注意：你需要把sourcepath设置成目标包的源文件所在的目录，例如：你在从c:jproject里有一个包cn.com.linuxaid，你想为它里面的文件生成文档，那么你就必须写成c:jprojectcncomlinuxaid。
-clathpath clathpathlist
指定javadoc查找“引用类”的路径，“引用类”是值带文档的类加上它们引用的任何类。javadoc将搜索指定路径的所有子目录。classpathlist可以包含多个路径，它们用分号分隔。
下面我们来举一个例子：
假设，我们需要在targetdocdir放置我们生成的文档，需要对c:jproject里的cn.com.linuxaid包内的源文件建立程序文档。那么我们需要进入c:jprojectcncom（也就是包含了overview.html的目录——假如你提供了它的话）。然后运行 javadoc -d targetdocdir cn.com.linuxaid
除了javadoc提供了丰富的选项参数来让你定制你所需要生成的程序文档以外，还可以借助doclet来产生任何形式的输出，具体的情况，请仔细阅读联机帮助文档。
