javadoc默认只处理public和protected修饰的内容,如果要提取private,只需在用javadoc时加-private选项。
另外javadoc只处理文档注释即为/**..................*/和只有对处于多个包下面大源文件来生成API文档时,才有概览页面。
javadoc命令的基本用法如下:
javadoc 选项 java源文件/包 选项 -d 生成文件名 -windowtitle 浏览器窗口标题 -doctitle 概述页面标题 -header 页眉 文档注释常用如下:
@version
@param
@throws
不过这些标记大使用是用位置限制的
结合一个例子:
第一类JavadocTest.java
package bb;/** 主要入口点*/public class JavadocTest{ public static void main(String[] args) { System.out.println("hello!javadoc"); }}
第二个类:Test.java
package yee;/** test test test*/public class Test{ /** age属性 */ public int age; //count public int count; public Test() { }}
命令执行:javaLearn$ javadoc -d apidoc -windowtitle 测试 -doctitle 学习javadoc工具测试api文档 -header 我的类 -encoding UTF-8 -charset UTF-8 *Test.java
如果项目是utf-8,为防止出现乱码,可以加入-encoding UTF-8 -charset UTF-8;
运行结果如下: