Behavioural change of {@code} regarding Unicode characters?
Jonathan Gibbons
jonathan.gibbons at oracle.com
Mon May 14 14:58:40 UTC 2018
Martin,
Thanks for the report; there is no intentional change in this area.
Can you give a specific example of a comment containing {@code} that
illustrates the issue, showing the exact representation of the Unicode
character?
I'll check out the doc comment spec, and fix the issue you mention.
-- Jon
On 5/14/18 3:31 AM, Martin Desruisseaux wrote:
>
> Hello
>
> I noticed a behavioural change of {@code} inline tag with Java 10. In
> Java versions 5 to 8, text inside {@code} was rendered literally,
> including Unicode characters outside ASCII range. But in Java 10,
> Unicode characters are replaced by the "\u" escape sequence. For example:
>
> {@code foo(…)}
>
> Was rendered as foo(…) in HTML javadoc generated by Java 8, but is now
> rendered as foo(\u2026) in javadoc generated by Java 10. Is this
> behavioural change intentional? I do not see notice about handling of
> Unicode characters in [1].
>
> Martin
>
> P.S.: in the documentation about {@literal}, the link to the {@code}
> tag at the end of the paragraph actually references {@link}.
>
> [1]https://docs.oracle.com/javase/10/docs/specs/doc-comment-spec.html#code
> [2]https://docs.oracle.com/javase/10/docs/specs/doc-comment-spec.html#literal
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20180514/ca2af7fd/attachment.html>
More information about the javadoc-dev
mailing list