Hi Brent,
I'm not sure we have a best practice for referring to other classes but
I think that the {@code } references
to Collator could be {@link java.text.Collator} and the @See tags can be
omitted.
It puts the link where the reader sees the reference and is just as
informative.
Otherwise, looks good.
Roger
On 10/7/2015 7:30 PM, Brent Christian wrote:
Hi,
Please review my doc/spec change (no code) for 8138824.
Bug: https://bugs.openjdk.java.net/browse/JDK-8138824
Webrev: http://cr.openjdk.java.net/~bchristi/8138824/webrev.0/
Specdiff:
http://cr.openjdk.java.net/~bchristi/8138824/specdiff.0/overview-summary.html
This change addresses a longstanding mismatch between spec and
implementation, clarifies comparison methods which do not account for
locale, and adds references to the locale-aware java.text.Collator.
Thanks,
-Brent
