RFR 7061590 : Javadoc issues in Charset and StandardCharsets
Jonathan Gibbons
jonathan.gibbons at oracle.com
Mon May 20 18:53:56 UTC 2019
Ivan,
You would do better to avoid the use of the shorthand "a.k.a." which may
not be known to many readers. In general, the style should be to avoid
abbreviations like this, including e.g. i.e. etc. (sic)
I recommend replacing "a.k.a." with "also known as:.
-- Jon
On 05/20/2019 11:48 AM, Ivan Gerasimov wrote:
> Hello!
>
> A few small javadoc issues.
>
> The most visible one is that the last dot in abbreviation a.k.a. is
> treated as a period, so the generated description appears broken (see
> [1]
> <https://docs.oracle.com/en/java/javase/12/docs/api/java.base/java/nio/charset/StandardCharsets.html>):
>
> static Charset ISO_8859_1 ISO Latin Alphabet No. 1, a.k.a.
> static Charset US_ASCII Seven-bit ASCII, a.k.a.
> ...
>
> Would you please help review the fix?
>
> BUGURL: https://bugs.openjdk.java.net/browse/JDK-7061590
> WEBREV: http://cr.openjdk.java.net/~igerasim/7061590/00/webrev/
>
> [1]
> https://docs.oracle.com/en/java/javase/12/docs/api/java.base/java/nio/charset/StandardCharsets.html
>
More information about the core-libs-dev
mailing list