Which packages are exported?

Jonathan Gibbons jonathan.gibbons at oracle.com
Mon May 16 16:40:48 UTC 2016


I guess there's two aspects to this discussion:

1. The packages listed in the summary page for a module.

For this, my expectation is that it may be more significant than just a 
CSS style.

For example, one possibility is that the packages could be listed in a 
table with different "tabs" for exported/non-exported packages, similar 
to the "table with tabs" used to show different subsets of methods, such 
as here:
http://download.java.net/java/jdk9/docs/api/java/lang/Object.html

2. Other appearances of a package name.

Here, we would have to list the various places where a package name 
could appear, and decide which if any should be subject to special CSS 
styling.  It has been instructive in the design to look at the 
relationship between types and packages to find a precedent for the 
relationship between packages and modules.  For example, I note there is 
no special styling for package-private types compared to public types.

-- Jon

On 05/16/2016 09:20 AM, Paul Benedict wrote:
> Okay. Well, if it hasn't been planned, I definitely would like to make 
> a feature request. Specifically, a CSS style for exported vs. 
> nonexported packages so they can be stylized differently.
>
> Cheers,
> Paul
>
> On Mon, May 16, 2016 at 11:10 AM, Jonathan Gibbons 
> <jonathan.gibbons at oracle.com <mailto:jonathan.gibbons at oracle.com>> wrote:
>
>     On 05/16/2016 07:52 AM, Paul Benedict wrote:
>
>         I was wondering if JavaDoc in JDK 9 provides any visual
>         indicator (color, format, textual output, or otherwise) to
>         indicate exported packages vs non-exported packages?
>
>         Cheers,
>         Paul
>
>
>     javadoc is still a work in progress, and somewhat late to the
>     module game.
>
>     By default, javadoc should only show exported packages for a
>     module, the same way by default it only shows public and protected
>     constructors and members for a class, but it should be able to
>     show all packages, just as it can show all constructors and members.
>
>     -- Jon
>
>

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


More information about the javadoc-dev mailing list