RFR: 8224052: Javadoc doesn't handle non-public intermediate types well

Jonathan Gibbons jonathan.gibbons at oracle.com
Thu Jan 16 01:14:32 UTC 2020

On 01/15/2020 03:47 PM, Jonathan Gibbons wrote:
> As regards package-private and private intermediate supertypes, in the 
> absence of any pre-existing comment to the contrary, your inclusion of 
> isPrivate in isUndocumentedEnclosure is morally justifiable, even if 
> it is a change in behavior in an absurdly weird corner case that (to 
> the best of my knowledge) is undocumented.

As further justification for this change in behavior to be regarded as a 
bug fix, I note that javac allows access to public methods of private 
intermediate supertypes.  This implies the behavior is required by JLS, 
and so is justification for javadoc documenting the available methods.

Toy files attached, for the record.

-- Jon
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Client.java
Type: text/x-java
Size: 148 bytes
Desc: not available
URL: <https://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20200115/9da386de/Client.java>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Demo.java
Type: text/x-java
Size: 341 bytes
Desc: not available
URL: <https://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20200115/9da386de/Demo.java>

More information about the javadoc-dev mailing list