README-builds.html

[Tim Bell]

On 06/18/12 10:25, Andrew Haley wrote:
> The README-builds.html instructions say...
>
> Slow Builds:
>
>      ...
>
>      Creating the javadocs can be very slow, if you are running
>      javadoc, consider skipping that step.
>
> But there is no information I can find about how to skip that step: I
> think it's NO_DOCS=true.

Look in make/jdk-rules.gmk lines 40 ... 44
     40  # GENERATE_DOCS determines if we ask for the docs target
     41  DOCS_TARGET = docs
     42  ifeq ($(GENERATE_DOCS),false)
     43    DOCS_TARGET =
     44  endif


If you do not want docs generated, add "GENERATE_DOCS=false" to your 
make command.


In case you decide to generate docs at some point, I suggest using a 
build system with plenty of RAM and increasing max heap size during the 
build.  The default -Xmx of '612m' is too small for javadoc.  Specify a 
value along the lines of MAX_VM_MEMORY=2048 or larger if you have the 
resources.

Hope this helps-

Tim