[7u10] Request for approval: 7166055: Javadoc for WeakHashMap contains misleading advice (original) (raw)

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