On Mar 21, 2018, at 2:21 PM, Stuart Marks <stuart.ma...@oracle.com> wrote:
>>> Such a refactoring would be prohibited by an @implSpec. >> Why then not an @implNote instead of an @apiNote? > The statement that was proposed: > This method is equivalent to write(b, 0, b.length). > is a statement about the semantics of writeBytes(b). Put another way, it > states that the requirements on the behavior of writeBytes(b) are equivalent > to those on write(b, 0, b.length). Those are statements about the API. > > I don't think anything needs to be said about implementation. I can see what you are saying now. It would be good to have comments from someone else as well. Thanks, Brian
