[7u10] Request for approval: 7166055: Javadoc for WeakHashMap contains misleading advice

Alan Bateman Alan.Bateman at oracle.com
Mon Sep 17 03:11:49 PDT 2012


On 17/09/2012 11:01, Artem Ananiev wrote:
>
> JavaDoc changes, even trivial corrections and clarifications, are 
> potential compatibility issues. Previously unverifiable statement can 
> become verifiable, and vice versa. We don't (can't!) change 
> compatibility tests in update releases, therefore we can't accept any 
> specification changes.
The discussion here relates to changes to non-normative text rather than 
a specification change. I don't think it matters too much if such 
changes are back-ported except that it might be a bit confusing to have 
a mismatch between the source code and the docs on java.sun.com (or 
docs.orcale.com nowadays).

-Alan



More information about the jdk7u-dev mailing list