java - 无法使用 Ant 编译 javadoc

Question

我正在开发一个 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

但是，当我运行时 Ant 编译我得到以下输出:

[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 属性的组合，但没有成功。我错过了什么？!提前致谢，问候，

莱纳斯

Answer 1

尝试使用以下命令。

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