Installation as ANT target:

Put the JUnitDoclet.jar and the tools.jar from your current JDK in
your class path. Since we recommend ANT for all build processes, we
describe it with that tool.

For each Project you create a build.xml defining all pathes, names,
directories and dependencies. The file should include targets like
these:
  ...
  <target name="junitdoclet" depends="compile">
    <javadoc
      packagenames    = "${package}.*"
      sourcepath      = "${source}"
      defaultexcludes = "yes"
      doclet          = "com.objectfab.tools.junitdoclet.JUnitDoclet"
      docletpathref   = "classpath_default"
      additionalparam = "-d ${test_case_dir} -buildall">

      <classpath refid = "classpath_default" />
    </javadoc>
  </target>

  <target name="junitcompile" depends="junitdoclet">
 	<javac srcdir="${test_case_dir}" destdir="${classes}" debug="on">
      <classpath refid="classpath_default" />
    </javac>
  </target>

  <target name="junittest" depends="junitcompile">
    <junit fork="yes" haltonfailure="no">
      <formatter type="plain" usefile="no"/>
      <test name="${testsuite}" />
      <classpath refid="classpath_default" />
    </junit>
  </target>
  ...

Are you sure, ANT is installed, JUnit is installed an the ANT
task for JUnit is working? (The junit-ANT-task is a so called
optional task, please read the ANT manual, how to install it.)

That is all the installation you need.

If you are using a fileset to define which classes to be 
processed by javadoc+JUnitDoclet, please be aware that no 
TestSuites will be generated. (TestSuites are generated 
for packages only.) You then may want to use the batchtest 
element of the junit ANT task. (Please see the ANT docs.)


Some note about source="1.4" :

The documentation of ANT 1.5 says, that the source option of the 
ANT task is not used with custom Doclets. (If you set source="1.4"
you make javadoc aware of the assert statement.) 

JUnitDoclet does not require this information but javadoc itself 
does (not just the Standard Doclet as the ANT folks guessed).

Please include -source="1.4" as part of additionalparam.


Troubleshooting :

If you experience any problems, please be aware the problem may
be anything from ANT, javadoc or JUnitDoclet. We suggest, you 
first have the regular javadoc ANT task working (generating HTML).
If that is ok, you introduce JUnitDoclet to that environment.
