I know I have to do the same for a few modules. Do you have a preference on the wording so it consistent to help reduce follow on changes:
The {@code java.XXX} module defines and exports the XXX API Is that the preferred direction? > On Jul 19, 2016, at 3:12 AM, Alan Bateman <alan.bate...@oracle.com> wrote: > > On 19/07/2016 02:57, joe darcy wrote: > >> Hi Brian, >> >> As as grammatical comment, I might start with "The {@code java.prefs} module >> defines ...", but otherwise, the change looks fine. > Also I think it's API rather than "APIs". > > At some point then we need to do a pass over all the javadoc comments in the > module-info.java files to get them consistent. In this case, I could imagine > changing in the future to just say that it defines and exports the > preferences API. > > -Alan <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif>Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037 Oracle Java Engineering 1 Network Drive Burlington, MA 01803 lance.ander...@oracle.com <mailto:lance.ander...@oracle.com>