building javadoc with modules

[Jonathan Gibbons]

Justin,

To follow up on this some more, can you tell me where you are getting 
"the java9 src.zip" that you refer to?
Or, if you can't recall, can you check the layout of the contents?

Is it like this:

    openjdk/ADDITIONAL_LICENSE_INFO
    openjdk/ASSEMBLY_EXCEPTION
    openjdk/bin
    openjdk/configure
    openjdk/doc
    openjdk/LICENSE
    openjdk/make
    openjdk/Makefile
    openjdk/README
    openjdk/src
    openjdk/test

Or more like this:

    java.base/com
    java.base/java
    java.base/javax
    java.base/jdk
    java.base/module-info.java
    java.base/sun
    java.compiler/javax
    java.compiler/module-info.java
    java.datatransfer/java
    java.datatransfer/module-info.java
    java.datatransfer/sun
    java.desktop/com
    java.desktop/java
    java.desktop/javax
    java.desktop/module-info.java
    etc

The first form is essentially a zip of the repo, that I found here, for 
JDK 10:
     https://download.java.net/openjdk/jdk10/ri/openjdk-10_src.zip
There is an equivalent one for JDK 9, here:
     https://download.java.net/openjdk/jdk9/ri/openjdk-9_src.zip
This is the form that I was using in my response yesterday.

The second form is "just" the sources, in a simple layout, and is 
specific to a single platform.
It does contain the generated sources.  This zip file is generated 
automatically during the
build on a specific platform.


-- Jon




On 08/27/2018 06:47 PM, Justin Lee wrote:
> I'm trying to runjavadocagainst the java9 src.zip and I have no idea 
> how to handle the modules.  Even if I go with the classic 
> "javadoc at sources" approach I get an error about too many modules 
> defined.  I've tried a number of variations but I can't quite seem to 
> crack that nut.
>
> My latest attempt looks like this:
>
>     javadoc -d /tmp/javadoc9 -html5 --module \
>          java.management.rmi \
>      jdk.packager.services \
>      jdk.scripting.nashorn.shell \
>          <more module names here...> \
>          -Xmaxerrs 1000 \
>          @source.files
>
>
>
> Does anyone have an example of running thejavadoctool from the command 
> line and generating docs for modularized code like this?  Thanks.
>
> -- 
> You can find me on the net at:
> http://antwerkz.com <http://antwerkz.com/> http://antwerkz.com/+
> http://antwerkz.com/twitter http://antwerkz.com/github

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20180830/83f271e5/attachment.html>