building docs (extension of partial build)

[Kelly O'Hair]

On Sep 19, 2012, at 7:14 AM, Magnus Ihse Bursie wrote:

> On 2012-09-18 20:04, Jonathan Gibbons wrote:
>> Build-infra folk,
>> 
>> Is there a way to build (just) the docs?  I don't see any obvious targets in common/makefiles/Makefile?
> 
> "make docs", works in the current build-infra. Not sure if that one got along with Kelly's latest changes.
> 
> It's a work in progress, mind you. I'm not sure if it produces anything usable at the moment. :-)
> 
> /Magnus

At the very top of the forest, you can:
    make NEWBUILD=true images javadocs

The top level javadocs target just does:
        cd common/makefiles && $(MAKE) -f MakefileJavadoc.gmk

You need a complete forest build for this to work, and it is new so could easily get broken.
It should be parallel build safe and incremental, but does need that full build.
No comparisons were done against the old javadoc generation.

I took this Makefile away from the jdk repository (at make/docs/Makefile) because I felt it
rightfully belonged to the entire jdk, not just the jdk repo.
I know that deploy and maybe install also runs javadoc, so we will probably need to deal
with those separately, ideally we can get all javadoc runs done my one Makefile.

-kto