[icedtea-web] RFC: More javadoc fixes for Java 8

Mon May 12 12:41:06 UTC 2014

On Sat, 2014-05-10 at 04:07 +0200, Jacob Wisor wrote:
> On 5/10/2014 2:14 AM Omair Majid wrote:
> > Hi,
> >
> > I recently tried compiling icedtea-web with java 8 and ran into more
> > javadoc issues. Apparently, self-enclosing tags (<br/>) are now not
> > allowed either.
> 
> Self-enclosing elements are actually required by the XML specification, hence 
> also by XHTML. Please do not remove them.

The premises on which doclint warnings are based is HTML 4.01
Transitional Loose[1]. Hence, it depends on the Doctype. XHTML or HTML 5
have different doctypes which would actually require the self-closing
"<br/>". More info here[2]. 

IMHO, the patch is fine.

Cheers,
Severin

[1] To be precise: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
[2]
http://mail.openjdk.java.net/pipermail/core-libs-dev/2013-July/019269.html