RFR: 8251496: Fix doclint warnings in jdk.net.httpserver [v3]

[Patrick Concannon]

On Wed, 9 Sep 2020 13:20:45 GMT, Roger Riggs <rriggs at openjdk.org> wrote:

>> Patrick Concannon has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   8251496: reworded abstract cstr comments; removed unnecessary punctuation
>
> src/jdk.httpserver/share/classes/com/sun/net/httpserver/Authenticator.java line 75:
> 
>> 73:
>> 74:         /**
>> 75:          * returns the response code to send to the client
> 
> Initial Capital and add a period please.

I will include this change in the separate issue I created to track the additional formatting needed in these files --
https://bugs.openjdk.java.net/browse/JDK-8252822

> src/jdk.httpserver/share/classes/com/sun/net/httpserver/Authenticator.java line 101:
> 
>> 99:         }
>> 100:         /**
>> 101:          * returns the authenticated user Principal
> 
> Capitalize and add a period.
> Check all the method for the first line comments.

Will include change in https://bugs.openjdk.java.net/browse/JDK-8252822

> src/jdk.httpserver/share/classes/com/sun/net/httpserver/HttpPrincipal.java line 74:
> 
>> 72:
>> 73:     /**
>> 74:      * returns the username this object was created with.
> 
> Capitalize and add a period.
> Please check all methods.

Will include change in https://bugs.openjdk.java.net/browse/JDK-8252822

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

PR: https://git.openjdk.java.net/jdk/pull/81