From patricka@exinet.co.za Tue Oct 3 08:27:21 2000 Return-Path: Mailing-List: contact ant-user-help@jakarta.apache.org; run by ezmlm Delivered-To: mailing list ant-user@jakarta.apache.org Received: (qmail 98913 invoked from network); 3 Oct 2000 08:27:21 -0000 Received: from smtp.icg1.edu.za (HELO firewall.intec.edu.za) (196.31.65.11) by locus.apache.org with SMTP; 3 Oct 2000 08:27:21 -0000 Received: (from nobody@localhost) by firewall.intec.edu.za (8.8.8/8.6.9) id KAA09087 for ; Tue, 3 Oct 2000 10:27:00 +0200 (SAST) Received: by firewall.intec.edu.za via recvmail id 8962; Tue Oct 3 10:25:49 2000 Date: Tue, 3 Oct 2000 10:25:25 +0200 (SAST) From: patricka@exinet.co.za (Paul Arzul) To: ant-user@jakarta.apache.org Subject: Re: problems specifing a javadoc doclet In-Reply-To: Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Spam-Rating: locus.apache.org 1.6.2 0/1000/N On Mon, 2 Oct 2000, Glenn McAllister wrote: : 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? sure thing: ---8<--- /jdk1.2.2/bin/javadoc -docletpath jdox/javadox.jar -doclet com.componentregistry.javadox.JavaDox -sourcepath . @filelist.txt --->8--- from the documentation[1]: ---8<--- It will generate a file... in the current directory. --->8--- as i understand it then, it is the unsupported destdir attribute of the _doclet_ that's fubar-ing it. you say that -d is standard doclet specific. the documentation[2] does say it's optional though: ---8<--- Options Provided by the Standard Doclet -d directory Specifies the destination directory where javadoc saves the generated HTML files. (The "d" means "destination.") _Omitting_ this option causes the files to be saved to the _current directory_. --->8--- if destdir wasn't mandatory, i think i wouldn't be having this problem. any workarounds, or should i patch the doclet? - p [1] http://www.componentregistry.com/jdox/entrypage.jsp [2] http://java.sun.com/products/jdk/1.2/docs/tooldocs/win32/javadoc.html#standard * * * : 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<--- : : : : : : : : : : --->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 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 Generate output via alternate doclet : [javadoc] -docletpath Specify where to find doclet class : files : [javadoc] -1.1 Generate output using JDK 1.1 : emulating doclet : [javadoc] -sourcepath Specify where to find source files : [javadoc] -classpath Specify where to find user class : files : [javadoc] -bootclasspath Override location of class files : loaded : [javadoc] by the bootstrap class loader : [javadoc] -extdirs Override location of installed : extensions : [javadoc] -verbose Output messages about what Javadoc is : doing : [javadoc] -locale Locale to be used, e.g. en_US or : en_US_WIN : [javadoc] -encoding Source file encoding name : [javadoc] -J Pass 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