8016370: javadoc warnings, unexpected </p> mostly

[Jonathan Gibbons]

The rules for </p> in HTML 5 are more complicated, so I would not 
advocate global removal of </p> at this point

http://www.w3.org/TR/2011/WD-html5-20110525/syntax.html#optional-tags
> A p element's end tag may be omitted if the p element is immediately 
> followed by an address, article, aside, blockquote, dir, div, dl, 
> fieldset, footer, form, h1, h2, h3, h4, h5, h6, header, hgroup, hr, 
> menu, nav, ol, p, pre, section, table, or ul, element, or if there is 
> no more content in the parent element and the parent element is not an 
> a element.

Note that output is currently 4.01 but it is reasonable to expect that 
HTML 5 may be adopted at some point.

-- Jon

On 06/11/2013 01:05 PM, Martin Buchholz wrote:
> Reviewed and approved, but I would go further and remove all uses of 
> </p> everywhere, since it's not needed for valid html.
>
>
> On Tue, Jun 11, 2013 at 12:42 PM, Alan Bateman 
> <Alan.Bateman at oracle.com <mailto:Alan.Bateman at oracle.com>> wrote:
>
>
>     I was playing with javadoc -Xlint recently and one set of issues
>     that it reports is unexpected </p> at the end of the initial
>     paragraph on many of the NIO methods. I thought this was a
>     false-positive but Jon Gibbons has convinced me otherwise.
>
>     So I'd like to fix the 200 or so warnings with the following patch:
>
>     http://cr.openjdk.java.net/~alanb/8016370/webrev/
>     <http://cr.openjdk.java.net/%7Ealanb/8016370/webrev/>
>
>     The 200 aren't obvious in the webrev because there is generated
>     code in the build (hence the update to the templates and the
>     script that generates the exception classes).
>
>     The simplest way to review this is to look at the patch file.
>
>     Thanks,
>
>     Alan.
>
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.openjdk.java.net/pipermail/nio-dev/attachments/20130611/94742e28/attachment.html