RFR: JDK-8290243: move seeTagToContent from HtmlDocletWriter to TagletWriterImpl

Pavel Rappo prappo at openjdk.org
Fri Jul 15 19:28:09 UTC 2022


On Fri, 15 Jul 2022 18:18:01 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/HtmlDocletWriter.java line 1682:
>> 
>>> 1680:                     return false;
>>> 1681:                 }
>>> 1682: 
>> 
>> Did you remove this method because the enclosing method, `commentTagsToContent`, is called only for a series of inline tags, which `@see` is not?
>
> Yes.  See this text in item 4 in the description:
> 
>>At this time, an "impossible" case was removed from HtmlDocletWriter.commentTagsToContent. The method is for handling text and inline tags, so the visitSee method to handle an isolated @see tag can never be called in practice.

It was only after I looked at the changes and asked the question that I finally read the description; sorry about that.

-------------

PR: https://git.openjdk.org/jdk/pull/9499


More information about the javadoc-dev mailing list