[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