RFR: 8177280: @see {@link} syntax should allow generic types
Jonathan Gibbons
jonathan.gibbons at oracle.com
Tue Feb 18 19:36:06 UTC 2020
On 02/18/2020 03:26 AM, Hannes Wallnöfer wrote:
> - In HtmlDocletWriter.seeTagToContent I changed the handling of the tag text to escape HTML characters if no label is specified. This causes „<„ and „>“ to be displayed in the browser instead of being interpreted as HTML tag if a generic link target can’t be resolved. This is potentially problematic since @see and @link can contain plain HTML content, but I think it’s ok since those cases are handled further up in HtmlDocletWriter.seeTagToContent.
Although the nature of the text is not well specified, it is a
significant behavioral change to make this change if it affects any
existing (valid) uses of '@see' and '@link'. I will look at this in
more detail as part of the review.
-- Jon
More information about the javadoc-dev
mailing list