无法用Ant编译javadoc

时间:2014-03-04 08:38:52

标签: java ant javadoc

我正在开发一个Java项目,并且不仅要编译整个应用程序,还要使用Apache Ant编译javadoc文档。

目前,我的build.xml脚本中的编译目标如下所示:

<target name="compile">
    <mkdir dir="${build.dir}"/>
    <mkdir dir="${classes.dir}"/>
    <mkdir dir="${jar.dir}"/>
    <javac includeantruntime="false" srcdir="${src.dir}" destdir="${classes.dir}" classpathref="classpath" />
    <javadoc 
      sourcefiles="${src.dir}" 
      destdir="${doc.dir}/forecast"
      classpath="classpath"
      author="true"
      version="true"
      use="true"
      windowtitle="${App-name}"
      doctitle="&lt;h1&gt;${App-name}&lt;/h1&gt;" />
  </target>

我的源文件可以在src / com // forecast目录中找到,并且都有标题

package com.<company_name>.forecast

然而,当我跑步时 蚂蚁编译 我得到以下输出:

[javadoc] Generating Javadoc
  [javadoc] Javadoc execution
  [javadoc] 1 error
  [javadoc] javadoc: error - Illegal package name: "/home/linus/fo/forecast/src/com/<company_name>/forecast"

并且没有创建javadoc。我想我已经尝试了几乎所有可能的Javadoc属性组合,但无济于事。我错过了什么?! 提前致谢, 的问候,

莱纳斯

2 个答案:

答案 0 :(得分:1)

尝试使用以下命令。

javadoc -sourcepath ./src *.java -d ./docs

答案 1 :(得分:0)

看起来没有正确识别包名称。你能尝试指定packagenames参数。

有更多信息,请here

示例:

<javadoc packagenames="com.dummy.test.*"
       sourcepath="src"
       excludepackagenames="com.dummy.test.doc-files.*"
       defaultexcludes="yes"
       destdir="docs/api"
       author="true"
       version="true"
       use="true"
       windowtitle="Test API">  </javadoc>