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