Please Review javadoc cleanup 8026516

roger riggs roger.riggs at oracle.com
Wed Oct 16 20:50:45 UTC 2013


Hi Lance,

The empty <p> tag is because in most cases it precedes a <ul> or a 
header <hx> .
So there is no content in the paragraph.

In the past using an empty <p> tag created some empty vertical space;
but i understand that's a misuse of <p>.
I didn't try to compensate for that in my updates but it does change the 
appearance since
the vertical space gone.  I'll have to look to see if there is some 
spacing control for <ul>
that would restore the spacing.

Roger

On 10/16/2013 4:37 PM, Lance Andersen - Oracle wrote:
> Hi Roger,
>
> I think what you have done is OK.
>
> I do have questions on should more be done in general so that we use <P> </P> (as I thought that was no required vs just a solo <P>?).   As I started to look through some of the JDBC warnings,  I saw more tags that I thought should have been reported by doclint as there were no closing </P>.  I see similar scenarios in for example Instant.java
>
> Trying to figure out how much we really need to do
>
> Best
> Lance
> On Oct 16, 2013, at 4:15 PM, roger riggs wrote:
>
>> Hi,
>>
>> Javadoc cleanup to satisfy javadoc -Xlint.
>>
>> Webrev:
>>    http://cr.openjdk.java.net/~rriggs/webrev-javadoc-8026516/
>>
>> Thanks, Roger
>>
>
>
> Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
> Oracle Java Engineering
> 1 Network Drive
> Burlington, MA 01803
> Lance.Andersen at oracle.com
>




More information about the core-libs-dev mailing list