RFR: JDK-8286604: Update InputStream and OutputStream to use @implSpec

[liach]

On Wed, 11 May 2022 20:40:30 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> While doing a CSR review of another issue, I noticed some cases in InputStream and OutputStream what would benefit from being upgraded to implSpec and related javadoc tags.
> 
> The "A subclass must provide an implementation of this method." statements on several abstract methods don't add much value, but I chose to leave them in for this request.
> 
> Please also review the corresponding CSR: https://bugs.openjdk.java.net/browse/JDK-8286605

src/java.base/share/classes/java/io/OutputStream.java line 151:

> 149:      * The {@code write} method of {@code OutputStream} calls
> 150:      * the write method of one argument on each of the bytes to be
> 151:      * written out. Subclasses are encouraged to override this method and

Shouldn't the "subclasses" information be part of the API Note?

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

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