javadoc工具生成本身的API文档

javadoc默认只处理public和protected修饰的内容,若是要提取private,只需在用javadoc时加-private选项。java

另外javadoc只处理文档注释即为/**..................*/和只有对处于多个包下面大源文件来生成API文档时,才有概览页面。api

javadoc命令的基本用法以下:浏览器

javadoc 选项 java源文件/包 选项 -d 生成文件名 -windowtitle 浏览器窗口标题 -doctitle 概述页面标题 -header 页眉 文档注释经常使用以下:
工具

@author 学习

@version 测试

@param
.net

@return
code

@see
utf-8

@exception 文档

@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;

运行结果以下:

apidoc

相关文章
相关标签/搜索