源代碼在C:\src 目錄下，其中 com.taiji其下可能有數(shù)十個(gè)子包，數(shù)百（千）個(gè)Java文件。目錄結(jié)構(gòu)如下：
- C:\
| src\
| com\
| taiji\
| ***
怎么才能以最簡捷的方式生成所有的API文檔呢？
c:\>
c:\>cd src
c:\src>javadoc -d doc -subpackages com.taiji
這樣就搞定了，最終生成的API文檔位于 c:\src\doc 目錄（該目錄是由javadoc.exe自動生成的）。
上面的用法利用了“當(dāng)前目錄”和“相對路徑”，當(dāng)然也可以用絕對路徑：
...>javadoc -d c:\doc -sourcepath c:\src -subpackages com.taiji
最終生成的API文檔位于 c:\doc 目錄（該目錄同樣是由javadoc.exe自動生成的）。
總結(jié)一下：
我們只用到了javadoc的三個(gè)參數(shù)： -d，-subpackages，-sourcepath，其中：
參數(shù) 說明
-d 指定API文檔的輸出目錄，默認(rèn)是當(dāng)前目錄。建議總是指定該參數(shù)。
-sourcepath 指定源代碼路徑，默認(rèn)是當(dāng)前目錄。 此參數(shù)通常是必須的。
-subpackages 以遞歸的方式處理各子包。關(guān)鍵參數(shù)！如果不使用本參數(shù)，每次只能處理一個(gè)子包（或需手工列出所有子包）。
注：以上示例要求 javadoc.exe 所在路徑位于系統(tǒng)環(huán)境變量“PATH”中。
補(bǔ)充兩點(diǎn)：
使用參數(shù) -author 可以將作者信息（@author ***）導(dǎo)出到最終生成的API文檔中， -version 可以生成版本信息。
最終完整的命令行是：
...>javadoc -d c:\doc -sourcepath c:\src -subpackages com.taiji -author -version
第二點(diǎn)是java源程序里面必須寫上package com.taiji.*相匹配的包名，否則javadoc會找不到源程序。