项目源码的根路径是 E:\androidworkspace\javadoc\src
项目结构:
项目源码:
net.qingtian.doc.Teacher:
package net.qingtian.doc; /** * 老师 * <img src="doc-files/Button.gif"> * @author 晴天 * @see net.qingtian.doc.aa#Student 参考 * */ public class Teacher { /** * 性别 */ public String sex; /** * 显示性别 */ public void showSex(){ } }net.qingtian.doc.aa.Student:
package net.qingtian.doc.aa; /** * 学生 * @author 晴天 */ public class Student { /** * 姓名 */ public String name; /** * 显示姓名 */ public void showName(){ } }net.qingtian.doc.package.html:
<head>1234</head><body>abcd<a href="http://www.mabinbin.com">晴天</a></body>
a)在e盘下创建mydoc文件夹,存放生成的api文档。
b)在windows下打开黑窗口,然后进入到项目源码的根目录,以上面的项目为例,源码根目录为E:\androidworkspace\javadoc\src
C:\Users\Administrator>e: E:\>cd E:\androidworkspace\javadoc\drc E:\androidworkspace\javadoc\src>c)在e盘下创建文件 e:\ file.txt (文件的名字可随意,只要后面使用的时候和这个对应就可以)。文件的内容为
net.qingtian.doc.aa net.qingtian.docd)在黑窗口执行命令:javadoc -d e:\mydoc e:\file.txt
即E:\androidworkspace\javadoc\src>javadoc -d e:\mydoc e:\file.txt
e)文档已经生成,查看
首先 javadoc命令的格式 javadoc [ options ] [ packagenames ] [ sourcefiles ] [ @files ]
1.options选项里 (-d e:\mydoc 设置输出路径) (-public/-protect/-private 设置哪些被生成文档)
2.使用javadoc时,可以使用以下参数 -sourcepath E:\androidworkspace\javadoc\src 来设置需要生成api文档的源码的根路径,在我们刚才的操作中我们没有使用该选项,因为我们把黑窗口的当前路径设置为源码的根路径了,所以可以不使用该选项。
3. 使用javadoc时,可以设置-classpath classpathlist 这个参数,类似于-sourcepath sourcepathlist,只是他们一个是源码的路径,一个是二进制的文件的路径,不如有引用的外部的jar文件时设置,并不很常用。
4.javadoc可以为包和为文件生成api文档两种,对于为包生成文档时,不能递归的生成。如果包比较多,那么我们需要把包全部做为参数放在黑窗口命令的最后,这样当然是不方便的。所以有一个简单些的方式,也是刚才demo中用到的,就是把这些包名放在一个文件里,在命令的最后指定使用这个文件就可以 @filePath
5.中文乱码,javadoc默认是GBK编码,如果项目里用的是utf-8编码,那么在javadoc命令里添加选项 -encoding UTF-8 -charset UTF-8
6.参考http://www.360doc.com/content/06/0901/14/5874_196090.shtml
原文地址:http://blog.csdn.net/bingospunky/article/details/41207921