RFR 8180410: ByteArrayOutputStream should not throw IOExceptions
brian.burkhalter at oracle.com
Thu Mar 22 15:15:29 UTC 2018
Thanks for the comments. It seems like we have agreement on using @apiNote instead of @implSpec.
On Mar 22, 2018, at 8:02 AM, Roger Riggs <Roger.Riggs at oracle.com> wrote:
> The use of the word 'equivalent' regardless of the context, only says the behavior is the same
> it does not mandate the implementation except that it behaves the same.
> Since the behavior of the method is already specified, adding the 'equivalent' statement
> only makes it easier for the developer to understand the behavior so it would be
> fine in an apiNote or just part of the description. Either way, from a conformance point of
> view, the statement should be ignored.
> If it was in an @implSpec clause, then I'd expect to be able to write a test that
> checks that the behavior is the same using only the API and not making any assumption
> about that the API invokes.
More information about the core-libs-dev