Hi Aleksei,
CompositeName.java readObject and writeObject methods should have a
generic first line comment.
CompositeName.java
BasicAttribute.java
BasicAttributes.java
For example,
* The WriteObject method is called to save the state of the
FilePermission to a stream.
* The readObject method is called to restore the state of the
FilePermission from a stream.
There are a lot of variations in the JDK that are find, as long as they
indicate reading or writing the
state from/to a stream.
It is conventional that javadoc tags for @param, @throws, etc. do not
end with a period "."
unless it forms a complete sentence.
Thanks, Roger
On 8/25/20 11:03 AM, Aleks Efimov wrote:
Hi,
The documentation of classes from "java.naming" module needs to be
improved to resolve javadoc -Xdoclint "no comment" warnings.
JBS issue: https://bugs.openjdk.java.net/browse/JDK-8251182
Webrev: http://cr.openjdk.java.net/~aefimov/8251182/00/index.html
CSR: https://bugs.openjdk.java.net/browse/JDK-8252310
With Best Regards,
Aleksei
