javadoc of modules

Jonathan Gibbons jonathan.gibbons at oracle.com
Sun Jan 22 17:53:56 UTC 2017


Hi Rémi,


On 1/21/17 1:22 AM, Remi Forax wrote:
> For the JDK, there are several kind of modules from a doc perspective,
> we have root modules that are available by default, like java.base,
> we have implementation modules, those that starts with jdk like jdk.jshell,
> and we have modules that are not root modules, i.e. available if you use --add-modules, like java.xml.bind.
>
> I think that the javadoc panel that display the avaialble modules, should
> - separate the different kind of modules, java.xml.bind should not be mixed with java.base if it will not be present in Java 10

I think that information would be better conveyed on an updated overview 
page -- the initial page displayed in the main panel.

> - have a way to see implementation modules and their corresponding javadoc.

That would be a different run of javadoc, with different options. Just 
as javadoc generates docs on the classes it is given, with a level of 
detail depending on the options it is given, so too is it with modules.

>
> regards,
> Rémi
-- Jon


More information about the jigsaw-dev mailing list