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