RFR: JDK-8286783: Expand use of @inheritDoc in InputStream and OutputStream subclasses

Alan Bateman alanb at openjdk.java.net
Sun May 15 19:28:46 UTC 2022


On Sun, 15 May 2022 18:36:07 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> Make the javadoc in the InputStream and OutputStream subclasses in core libs DRY-er by use of inheritDoc. (Any analagous changes to AudioInputStream in client libs will be done another a separate bug.) When the time comes, will do any necessary merging for the changes in[JDK-8286200.
> 
> Please also review the CSR to cover the introduction of implspec and implNote tags: https://bugs.openjdk.java.net/browse/JDK-8286784

Picking FileInputStream at random, I wonder if the `@inheritDoc` on transferTo is needed. Also, I think you've attempted to add `@Override` to all overridden methods but some may have been missed (e.g. readAllBytes and readNBytes).

-------------

PR: https://git.openjdk.java.net/jdk/pull/8717


More information about the core-libs-dev mailing list