On 21/07/2016 17:37, Lance Andersen wrote:

I took a stab at the javadoc descriptions for the modules modeled after what we 
discussed for the java.prefs module.

The webrev can be found at http://cr.openjdk.java.net/~lancea/8161965/ 
<http://cr.openjdk.java.net/~lancea/8161965/>
It's good to do these in bulk and get some consistently.

A general comment is that it uses acronyms for several APIs. For example java.xml say "JAXP" then I assume it should have "XML Processing". JDBC, JNDI, JAXB, ... there are several that I think should be clearer.

java.activation has "activation API", shouldn't this be "JavaBeans Activation Framework".

I'm not sure what to say for java.annotations.common. I think it has to say something about it defining a subset of the Common Annotations.

For java.transaction then the exceptions also for interop with CORBA Transaction Services. The text might need to say that it's the Java SE subset of the Java Transaction API.

The java.management module exports java.lang.management so that will need text.

I think Jon Gibbons is working on text for java.compiler and jdk.compiler so you might be able to drop java.compiler from your patch.

-Alan




Reply via email to