javadoc problem, using ant build file

[billo bailey]

Hi all,
I'm new to javadoc. I am trying to javadoc a package using javadoc from an ant build file but can't get it to fire, I've tried various (and ridiculous) combinations but am stuck. Can someone see what I'm doing wrong. Here's the output I get:

Buildfile: C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\build.xml
init:
build:
    [javac] Compiling 14 source files to C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\build
dist:
      [jar] Building jar: C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\dist\journeyTimeEstimator.jar
javadoc:
   [delete] Deleting directory C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\javadoc
    [mkdir] Created dir: C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\javadoc
  [javadoc] Generating Javadoc
  [javadoc] Javadoc execution
  [javadoc] Loading source files for package journeyTimeEstimator...
  [javadoc] Constructing Javadoc information...
  [javadoc] javadoc: warning - No source files for package journeyTimeEstimator
  [javadoc] 1 warning
  [javadoc] No public or protected classes found to document.
clean:
   [delete] Deleting directory C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\build
   [delete] Deleting directory C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\dist
   [delete] Deleting directory C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\junit-results
init:
    [mkdir] Created dir: C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\build
    [mkdir] Created dir: C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\dist
    [mkdir] Created dir: C:\Program Files\eclipse\eclipse\workspace\JourneyTimeEstimator\junit-results
BUILD SUCCESSFUL
Total time: 5 seconds
  

and here's my build.xml:

 <project name="journeyTimeEstimator" default="dist" basedir=".">
  <description>Journey time estimation programme</description>
 
  <property name="src.dir"   value="src"/>
  <property name="build.dir" value="build"/>
  <property name="dist.dir"  value="dist"/>
  <property name="test.dir"  value="test"/>
  <property name="junit.dir" value="junit-results"/>
  <property name="packages" value="journeyTimeEstimator/*"/>
  <property name="javadoc.dir" value="javadoc"/>
  
  <property name="junit.jar" location="C:\Program Files\eclipse\eclipse\plugins\org.junit_3.8.1" />
<!--<property name="junit.jar" location="C:\eclipse\plugins\org.junit_3.8.1\"/>-->
  <property name="test.class" value="src.test.AllTests"/>
 
  <path id="classpath">
    <pathelement location="${build.dir}" />
    <pathelement location="${junit.jar}" />
  <pathelement location="${javadoc.dir}" />
  </path>
 
  <target name="init">
    <mkdir dir="${build.dir}"/>
    <mkdir dir="${dist.dir}"/>
    <mkdir dir="${junit.dir}"/>
  <mkdir dir="${javadoc.dir}"/>
  </target>
 
  <target name="build" depends="init" description="build everything under ${src.dir}" >
    <javac srcdir="${src.dir}" destdir="${build.dir}">
      <classpath refid="classpath"/>
    </javac>
  </target>

  <target name="javadoc">
  <delete dir="${javadoc.dir}"/>
  <mkdir  dir="${javadoc.dir}"/>
  <javadoc packagenames="${packages}"
   sourcepath="${src.dir}"
             destdir="${javadoc.dir}"
             author="true"
             version="true"
             windowtitle="${Name} API"
             doctitle="${Name}"
             bottom="Copyright �� 2000 GroupServe. All Rights Reserved."
   />
 </target>
 
  <target name="test" depends="build" description="unit test" >
    <junit errorProperty="test.failed" failureProperty="test.failed">
      <test name="${test.class}" todir="${junit.dir}" />
      <formatter type="brief" usefile="false" />
      <formatter type="xml" />
      <classpath refid="classpath" />
    </junit>
    <fail message="Tests failed: check test reports." if="test.failed" />
  </target>
 
  <target name="dist" depends="build" description="generate the distribution" >
    <jar jarfile="${dist.dir}/journeyTimeEstimator.jar" basedir="${build.dir}">
      <manifest>
        <attribute name="Main-Class" value="src.journeyTimeEstimator.JourneyTimeEstimator"/>
      </manifest>
    </jar>
  </target>
 
  <!--<target name="run" depends="dist">
    <java jar="${dist.dir}\journeyTimeEstimator.jar" fork="true" />
  </target>-->
 
  <target name="clean" description="clean up" >
    <delete dir="${build.dir}"/>
    <delete dir="${dist.dir}"/>
    <delete dir="${junit.dir}"/>
  </target>
</project>
 

Thanks for any help.

[Roseanne Zhang]

Why don't you execute a simple javadoc on an existing source such as com.myco.mypkg.HelloWorld.java to test how it works? After you make it work on HelloWorld, you might find out what went wrong in your ant script easily.

From my experience, HelloWorld kind of stuff always helps.

[billo bailey]

thanks I'll give that a whirl.