RFR: 8012675: Javadoc for javax.swing.text.html.parser.Parser.handleComment() needs to be updated [v16]

[Damon Nguyen]

On Thu, 16 Jun 2022 20:46:35 GMT, Alexey Ivanov <aivanov at openjdk.org> wrote:

>> src/java.desktop/share/classes/javax/swing/text/html/HTMLEditorKit.java line 1314:
>> 
>>> 1312:      *     <li>The content within the tags will be handled by the editor as
>>> 1313:      *     regular text.</li>
>>> 1314:      * </ul>
>> 
>> You should close `</li>` not on the first line but after closing `</ul>`: the inner `<ul>` has to be inside a list item.
>> 
>> The list should look like:
>> 
>> <ul>
>>     <li>Outer 1st
>>         <ul>
>>             <li>Inner</li>
>>         </ul>
>>    </li>
>>    <li>Outer 2nd</li>
>> </ul>
>
>> You should close `</li>` not on the first line but after closing `</ul>`: the inner `<ul>` has to be inside a list item.
> 
> `make docs` also reports an error here:
> 
> 
> ...\javax\swing\text\html\HTMLEditorKit.java:1310:
> error: tag not allowed here: <ul>
>      * <ul>
>        ^

@aivanov-jdk I believe I fixed it. I ran make docs and I got no errors now.

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

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