JDK 8 code review request for doclint issues in java.lang.instrument

[Jonathan Gibbons]

Yes, doclint is enforcing the HTML 4.01 spec for JDK 8.

http://www.w3.org/TR/REC-html40/

This is in accordance with the DOCTYPE declaration generated at the 
beginning of all javadoc-generated files.

FWIW, <p/> is *always* wrong.  It would signify an empty paragraph, 
equivalent to <p></p>.

-- Jon


On 09/27/2013 10:00 AM, Joe Darcy wrote:
> Adding Jon Gibbons, author of doclint.
>
> Sergey, currently doclint is enforcing the rules of HTML 4 rather than 
> HTML 5. At some point in the future, we may migrate to HTML 5.
>
> -Joe
>
> On 9/27/2013 4:08 AM, Sergey Bylokhov wrote:
>> Hello,
>> I have a question about of <p/> = > <p>. Should we follow html 
>> specification[1] here or we should always replace <p/> to <p>?
>> [1] http://dev.w3.org/html5/markup/p.html#p
>> see@ Tag omission
>>
>> On 01.07.2013 22:47, Alan Bateman wrote:
>>> On 01/07/2013 19:24, Joe Darcy wrote:
>>>> Hello,
>>>>
>>>> Yet another found of doclint fixes for review; this batch to 
>>>> java.lang.instrument.
>>>>
>>>> Thanks,
>>>>
>>>> -Joe
>>> This looks okay to me.
>>>
>>> -Alan
>>
>>
>