ant-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ivan Ivanov <rambiusparkisan...@yahoo.com>
Subject Re: build.xml for javadoc of entire folder tree
Date Tue, 12 Jul 2005 18:07:14 GMT
Hello,

--- JS developer <js_dev@rediffmail.com> wrote:

> hi, 
> i'm a beginner with ant, i want to generate the
> javadoc for the entire src.zip that comes with the
> sun jdk download. 
Quite an ambitious undertaking :). Why don't you just
download it from[1]. Anyway, it you want it for
educational purposes, here are some guideliness:
0) Read <javadoc> task documentation[2]
1) <javadoc> task will (in this case) a very long
command line, that might exceeed the maximal command
line length for some OS. If so, use useexternalfile
attribute of <javadoc> task
2) It will definitely consume a great deal with memory
so you should increase the maximum heap size using
ANT_OPTS environement variable[3]. In fact, I run the
following snippet with 512m heap size and it fails
with an OutOfMemoryError:
<javadoc author="yes"
  destdir="C:\\j2sdk1.4.2_03\\javadocs"
  useexternalfile="true"
  package="yes">
  <fileset dir="C:\\j2sdk1.4.2_03\\src">
    <include name="**/*.java"/>
  </fileset>
</javadoc>

Regards
Ivan

[1]http://java.sun.com/j2se/1.5.0/download.jsp
[2]http://ant.apache.org/manual/CoreTasks/javadoc.html
[3]http://ant.apache.org/manual/running.html#envvars
> 
> Thanks in advance,
> JS



		
____________________________________________________
Sell on Yahoo! Auctions – no fees. Bid on great items.  
http://auctions.yahoo.com/

---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org


Mime
View raw message