--- old/src/java.base/share/classes/module-info.java	2016-07-28 17:12:33.000000000 -0400
+++ new/src/java.base/share/classes/module-info.java	2016-07-28 17:12:33.000000000 -0400
@@ -24,7 +24,7 @@
  */
 
 /**
- * java.base defines and exports the core APIs of the Java SE platform.
+ * Defines the core Java SE API.
  */
 
 module java.base {
--- old/src/java.compact1/share/classes/module-info.java	2016-07-28 17:12:35.000000000 -0400
+++ new/src/java.compact1/share/classes/module-info.java	2016-07-28 17:12:34.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Aggregates {@code java.base}, {@code java.logging}, and {@code java.scripting}.
+ */
 module java.compact1 {
     requires public java.logging;
     requires public java.scripting;
--- old/src/java.compact2/share/classes/module-info.java	2016-07-28 17:12:36.000000000 -0400
+++ new/src/java.compact2/share/classes/module-info.java	2016-07-28 17:12:36.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Supplements {@code java.compact1} with JDBC, JAXP, and RMI.
+ */
 module java.compact2 {
     requires public java.compact1;
     requires public java.rmi;
--- old/src/java.compact3/share/classes/module-info.java	2016-07-28 17:12:38.000000000 -0400
+++ new/src/java.compact3/share/classes/module-info.java	2016-07-28 17:12:38.000000000 -0400
@@ -23,6 +23,10 @@
  * questions.
  */
 
+/**
+ * Supplements {@code java.compact2} with JDBC RowSet, JNDI, Profiling,
+ * Security, and Compiler APIs.
+ */
 module java.compact3 {
     requires public java.compact2;
     requires public java.compiler;
--- old/src/java.datatransfer/share/classes/module-info.java	2016-07-28 17:12:39.000000000 -0400
+++ new/src/java.datatransfer/share/classes/module-info.java	2016-07-28 17:12:39.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines an API for transferring data between and within applications.
+ */
 module java.datatransfer {
     exports java.awt.datatransfer;
     exports sun.datatransfer to java.desktop;
--- old/src/java.desktop/share/classes/module-info.java	2016-07-28 17:12:41.000000000 -0400
+++ new/src/java.desktop/share/classes/module-info.java	2016-07-28 17:12:41.000000000 -0400
@@ -23,6 +23,10 @@
  * questions.
  */
 
+/**
+ * Defines the AWT and Swing user interface toolkits, plus APIs for
+ * accessibility, audio, imaging, printing, and JavaBeans.
+ */
 module java.desktop {
     requires public java.datatransfer;
     requires public java.xml;
--- old/src/java.httpclient/share/classes/module-info.java	2016-07-28 17:12:42.000000000 -0400
+++ new/src/java.httpclient/share/classes/module-info.java	2016-07-28 17:12:42.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the high level HTTP and WebSocket API.
+ */
 module java.httpclient {
     requires java.base;
     exports java.net.http;
--- old/src/java.instrument/share/classes/module-info.java	2016-07-28 17:12:44.000000000 -0400
+++ new/src/java.instrument/share/classes/module-info.java	2016-07-28 17:12:44.000000000 -0400
@@ -23,6 +23,10 @@
  * questions.
  */
 
+/**
+ * Defines services that allow Java programming language agents to
+ * instrument programs running on the JVM.
+ */
 module java.instrument {
     exports java.lang.instrument;
 }
--- old/src/java.logging/share/classes/module-info.java	2016-07-28 17:12:45.000000000 -0400
+++ new/src/java.logging/share/classes/module-info.java	2016-07-28 17:12:45.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the Java Logging API.
+ */
 module java.logging {
     exports java.util.logging;
     provides jdk.internal.logger.DefaultLoggerFinder with
--- old/src/java.management/share/classes/module-info.java	2016-07-28 17:12:47.000000000 -0400
+++ new/src/java.management/share/classes/module-info.java	2016-07-28 17:12:47.000000000 -0400
@@ -23,6 +23,11 @@
  * questions.
  */
 
+/**
+ * Defines the Java Management Extensions (JMX) API,
+ * interfaces for monitoring and management of the Java Virtual Machine
+ * and other components in the Java runtime.
+ */
 module java.management {
     requires public java.rmi;
     requires java.logging;
--- old/src/java.naming/share/classes/module-info.java	2016-07-28 17:12:50.000000000 -0400
+++ new/src/java.naming/share/classes/module-info.java	2016-07-28 17:12:50.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines and exports the Java Naming and Directory Interface (JNDI) API.
+ */
 module java.naming {
     requires java.security.sasl;
 
--- old/src/java.prefs/share/classes/module-info.java	2016-07-28 17:12:52.000000000 -0400
+++ new/src/java.prefs/share/classes/module-info.java	2016-07-28 17:12:52.000000000 -0400
@@ -23,6 +23,10 @@
  * questions.
  */
 
+/**
+ * Defines the Preferences API.
+ */
+
 module java.prefs {
     requires java.xml;
 
--- old/src/java.rmi/share/classes/module-info.java	2016-07-28 17:12:54.000000000 -0400
+++ new/src/java.rmi/share/classes/module-info.java	2016-07-28 17:12:53.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the Remote Method Invocation (RMI) API.
+ */
 module java.rmi {
     requires java.logging;
 
--- old/src/java.scripting/share/classes/module-info.java	2016-07-28 17:12:55.000000000 -0400
+++ new/src/java.scripting/share/classes/module-info.java	2016-07-28 17:12:55.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the scripting API.
+ */
 module java.scripting {
     exports javax.script;
     uses javax.script.ScriptEngineFactory;
--- old/src/java.se.ee/share/classes/module-info.java	2016-07-28 17:12:57.000000000 -0400
+++ new/src/java.se.ee/share/classes/module-info.java	2016-07-28 17:12:56.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the upgradeable modules for Java EE technologies.
+ */
 module java.se.ee {
 
     requires public java.se;
--- old/src/java.se/share/classes/module-info.java	2016-07-28 17:12:58.000000000 -0400
+++ new/src/java.se/share/classes/module-info.java	2016-07-28 17:12:58.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the API of the Java SE Platform.
+ */
 module java.se {
     requires public java.compact3;
     requires public java.datatransfer;
--- old/src/java.security.jgss/share/classes/module-info.java	2016-07-28 17:13:00.000000000 -0400
+++ new/src/java.security.jgss/share/classes/module-info.java	2016-07-28 17:13:00.000000000 -0400
@@ -23,6 +23,11 @@
  * questions.
  */
 
+/**
+ * Defines the Java binding of the IETF Generic Security Services API (GSS-API).
+ * <P>
+ * This module also includes GSS-API mechanisms such as Kerberos v5 and SPNEGO.
+ */
 module java.security.jgss {
     requires java.naming;
     exports javax.security.auth.kerberos;
--- old/src/java.security.sasl/share/classes/module-info.java	2016-07-28 17:13:02.000000000 -0400
+++ new/src/java.security.sasl/share/classes/module-info.java	2016-07-28 17:13:01.000000000 -0400
@@ -23,6 +23,13 @@
  * questions.
  */
 
+/**
+ * Defines Java support for the IETF Simple Authentication and Security Layer
+ * (SASL).
+ * <P>
+ * This module also includes SASL mechanisms such as DIGEST-MD5,
+ * CRAM-MD5, and NTLM.
+ */
 module java.security.sasl {
     requires java.logging;
 
--- old/src/java.smartcardio/share/classes/module-info.java	2016-07-28 17:13:05.000000000 -0400
+++ new/src/java.smartcardio/share/classes/module-info.java	2016-07-28 17:13:05.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the Java Smart Card I/O API.
+ */
 module java.smartcardio {
     exports javax.smartcardio;
     provides java.security.Provider with sun.security.smartcardio.SunPCSC;
--- old/src/java.sql.rowset/share/classes/module-info.java	2016-07-28 17:13:08.000000000 -0400
+++ new/src/java.sql.rowset/share/classes/module-info.java	2016-07-28 17:13:07.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the JDBC RowSet API.
+ */
 module java.sql.rowset {
     requires public java.logging;
     requires public java.naming;
--- old/src/java.sql/share/classes/module-info.java	2016-07-28 17:13:11.000000000 -0400
+++ new/src/java.sql/share/classes/module-info.java	2016-07-28 17:13:10.000000000 -0400
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the JDBC API.
+ */
 module java.sql {
     requires public java.logging;
     requires public java.xml;
--- old/src/java.transaction/share/classes/module-info.java	2016-07-28 17:13:14.000000000 -0400
+++ new/src/java.transaction/share/classes/module-info.java	2016-07-28 17:13:14.000000000 -0400
@@ -23,6 +23,13 @@
  * questions.
  */
 
+/**
+ * Defines a subset of the Java Transaction API to support CORBA interop.
+ * <P>
+ * The subset consists of exception types to which certain CORBA system
+ * exceptions are mapped at run time. The mapping is specified in the
+ * Java Language to IDL Mapping (OMG ptc/2003-01-17).
+ */
 module java.transaction {
     requires public java.rmi;
     exports javax.transaction;
--- old/src/java.xml.crypto/share/classes/module-info.java	2016-07-28 17:13:19.000000000 -0400
+++ new/src/java.xml.crypto/share/classes/module-info.java	2016-07-28 17:13:18.000000000 -0400
@@ -23,6 +23,9 @@
  * questions.
  */
 
+/**
+ * Defines the common classes for XML cryptography.
+ */
 module java.xml.crypto {
     requires public java.xml;
     requires java.logging;