ant-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Glenn McAllister" <gle...@ca.ibm.com>
Subject Re: problems specifing a javadoc doclet
Date Mon, 02 Oct 2000 16:47:41 GMT


The problem you are running into is that the destdir attribute translates
to the -d javadoc command line options.  Unfortunately, -d is _standard
doclet specific_, not common to javadoc itself.  In all likelyhood (having
never used JavaDox) they have a different flag for the output directory.
If the doclet wasn't being found you would see that error before the -d
problem.

Could you show us your command line that works?

Glenn McAllister
Software Developer. IBM Toronto Lab, (416) 448-3805
"An approximate answer to the right question is better than the
right answer to the wrong question." - John W. Tukey


patricka@exinet.co.za (Paul Arzul) on 10/02/2000 12:09:58 PM

Please respond to ant-user@jakarta.apache.org

To:   ant-user@jakarta.apache.org
cc:
Subject:  problems specifing a javadoc doclet




i cannot get javadoc doclets to work with ant
1.1. variations on the sample below all produce a javadoc
invalid flag -d error. from the command line (outside ant),
it works dandy.

sample project:

---8<---
<?xml version="1.0"?>

<project name="Doclet Test" default="jdox" basedir=".">

  <target name="jdox">
    <javadoc
      sourcepath="."
      destdir="."
      packagenames="*"
      doclet="com.componentregistry.javadox.JavaDox"
      docletpath="javadox.jar"
      failonerror="yes" />
  </target>

</project>
--->8---


typical error:

---8<---
Buildfile: test.xml

jdox:
  [javadoc] Generating Javadoc
  [javadoc] Javadoc execution
  [javadoc] javadoc: invalid flag: -d
                     ^
  [javadoc] usage: javadoc [options] [packagenames] [sourcefiles]
[classnames] [@files]
  [javadoc] -overview <file>          Read overview documentation from HTML
file
  [javadoc] -public                   Show only public classes and members
  [javadoc] -protected                Show protected/public classes and
members (default)
  [javadoc] -package                  Show package/protected/public classes
and members
  [javadoc] -private                  Show all classes and members
  [javadoc] -help                     Display command line options
  [javadoc] -doclet <class>           Generate output via alternate doclet
  [javadoc] -docletpath <path>        Specify where to find doclet class
files
  [javadoc] -1.1                      Generate output using JDK 1.1
emulating doclet
  [javadoc] -sourcepath <pathlist>    Specify where to find source files
  [javadoc] -classpath <pathlist>     Specify where to find user class
files
  [javadoc] -bootclasspath <pathlist> Override location of class files
loaded
  [javadoc]                by the bootstrap class loader
  [javadoc] -extdirs <dirlist>        Override location of installed
extensions
  [javadoc] -verbose                  Output messages about what Javadoc is
doing
  [javadoc] -locale <name>            Locale to be used, e.g. en_US or
en_US_WIN
  [javadoc] -encoding <name>          Source file encoding name
  [javadoc] -J<flag>                  Pass <flag> directly to the runtime
system
  [javadoc]
  [javadoc] 1 error

BUILD FAILED

test.xml:12: Exec returned: 1

Total time: 6 seconds
--->8---

suggestions appreciated,
tia,

- p





Mime
View raw message