javadoc and API docs

[Jonathan Gibbons]

Right now, in the current build, we use a "hybrid" javadoc to build the 
API documentation, where "hybrid" means: latest sources, running on 
bootstrap JDK.

Looking to the future, at least for Jigsaw, and now maybe for JSR 308, 
we may need to run javadoc on the newly built JDK.  Does anyone see any 
problems with doing that?

-- Jon