如何在Ant的javadoc任务中链接第三方库

Question

我有一个项目,它使用jar文件形式的第三方库,我使用Ant来构建项目javadocs.使用javadoc任务时,我无法让Ant链接到第三方库javadocs.

这是javadoc任务:

<javadoc excludepackagenames="" access="private" destdir="javadoc" author="true" 
         version="true" use="true" windowtitle="title" useexternalfile="true">
  <fileset dir="." defaultexcludes="yes">
    <include name="*/src/com/**/*.java"/>
  </fileset>

  <link href="http://www.redhillconsulting.com.au/products/simian/javadoc/"/> 
  <link href="http://java.sun.com/j2se/1.5.0/docs/api/"/>
</javadoc>

任务的输出表明simian包不存在:

[javadoc] C:\development\java\tools\src\com\cname\DuplicateCodeIdentifier.java:15: package au.com.redhillconsulting.simian does not exist
[javadoc] import au.com.redhillconsulting.simian.Checker;
[javadoc]                                        ^

运行ant任务会正确创建到Sun网站的所有链接,但不会创建到redhillconsulting网站.两个URL都会导致包列表文件和适当的路径(匹配包列表内容).

如何配置<javadoc>Ant任务以生成指向第三方站点的链接？

注意:simian jar文件位于tools/lib中.我没有看到它指定任何类型的路径是一个选项,所以我没有探索该途径,但我已经尝试将jar文件添加到文件集包含路径,这没有任何好处.

Answer 1

该javadoc标签接受的嵌入式classpath标签

<javadoc ...>
    <classpath>
        <fileset dir="${dir.lib}">
            <include name="simian.jar"/>
        </fileset>
    </classpath>
</javadoc>