--- old/src/java.base/share/classes/module-info.java	2017-11-07 16:03:44.000000000 -0800
+++ new/src/java.base/share/classes/module-info.java	2017-11-07 16:03:44.000000000 -0800
@@ -27,21 +27,19 @@
  * Defines the foundational APIs of the Java SE Platform.
  *
  * <dl>
- * <dt class="simpleTagLabel" style="font-family:'DejaVu Sans', Arial, Helvetica, sans serif">Providers:</dt>
- * <dd> The JDK implementation of this module provides an implementation of
- *      the {@index jrt jrt} {@linkplain java.nio.file.spi.FileSystemProvider
- *      file system provider} to enumerate and read the class and resource
- *      files in a run-time image.
- *      The jrt file system can be created by calling
- *      {@link java.nio.file.FileSystems#newFileSystem
- *      FileSystems.newFileSystem(URI.create("jrt:/"))}.
- *      </dd>
  * <dt class="simpleTagLabel" style="font-family:'DejaVu Sans', Arial, Helvetica, sans serif">Tool Guides:</dt>
  * <dd style="font-family:'DejaVu Sans', Arial, Helvetica, sans serif"> {@extLink java_tool_reference java launcher},
  *      {@extLink keytool_tool_reference keytool}</dd>
  * </dl>
  *
  * @provides java.nio.file.spi.FileSystemProvider
+ *      The JDK implementation of this module provides an implementation of
+ *      the {@index jrt jrt} {@linkplain java.nio.file.spi.FileSystemProvider
+ *      file system provider} to enumerate and read the class and resource
+ *      files in a run-time image.
+ *      The jrt file system can be created by calling
+ *      {@link java.nio.file.FileSystems#newFileSystem
+ *      FileSystems.newFileSystem(URI.create("jrt:/"))}.
  *
  * @uses java.lang.System.LoggerFinder
  * @uses java.net.ContentHandlerFactory
--- old/src/java.management.rmi/share/classes/module-info.java	2017-11-07 16:03:45.000000000 -0800
+++ new/src/java.management.rmi/share/classes/module-info.java	2017-11-07 16:03:45.000000000 -0800
@@ -27,25 +27,20 @@
  * Defines the {@linkplain javax.management.remote.rmi RMI connector}
  * for the Java Management Extensions (JMX) Remote API.
  *
- * <dl>
- * <dt class="simpleTagLabel" style="font-family:'DejaVu Sans', Arial, Helvetica, sans serif">Providers:</dt>
- * <dd>This module provides the
- * {@link javax.management.remote.JMXConnectorProvider} service,
- * which creates JMX connector clients using the RMI protocol.
+ * @provides javax.management.remote.JMXConnectorProvider
+ * Provides a {@link javax.management.remote.JMXConnectorProvider}
+ * service that creates JMX connector clients using the RMI protocol.
  * Instances of {@code JMXConnector} can be obtained via the
  * {@link javax.management.remote.JMXConnectorFactory#newJMXConnector
  * JMXConnectorFactory.newJMXConnector} factory method.
- * It also provides the {@link javax.management.remote.JMXConnectorServerProvider} service,
- * which creates JMX connector servers using the RMI protocol.
+ *
+ * @provides javax.management.remote.JMXConnectorServerProvider
+ * Provides a {@link javax.management.remote.JMXConnectorServerProvider} service,
+ * that creates JMX connector servers using the RMI protocol.
  * Instances of {@code JMXConnectorServer} can be obtained via the
  * {@link javax.management.remote.JMXConnectorServerFactory#newJMXConnectorServer
  * JMXConnectorServerFactory.newJMXConnectorServer} factory method.
- * </dd>
- * </dl>
- *
- * @provides javax.management.remote.JMXConnectorProvider
- * @provides javax.management.remote.JMXConnectorServerProvider
- *
+
  * @moduleGraph
  * @since 9
  */
--- old/src/java.management/share/classes/module-info.java	2017-11-07 16:03:46.000000000 -0800
+++ new/src/java.management/share/classes/module-info.java	2017-11-07 16:03:46.000000000 -0800
@@ -30,7 +30,15 @@
  * JVM and other components in the Java runtime.
  *
  * @uses javax.management.remote.JMXConnectorProvider
+ * The {@link javax.management.remote.JMXConnectorFactory#newJMXConnector
+ * JMXConnectorFactory.newJMXConnector} factory method uses this service
+ * to create {@linkplain javax.management.remote.JMXConnector connector clients}.
+ *
  * @uses javax.management.remote.JMXConnectorServerProvider
+ * The {@link javax.management.remote.JMXConnectorServerFactory#newJMXConnectorServer
+ * JMXConnectorServerFactory.newJMXConnectorServer} factory method uses
+ * this service to create {@linkplain javax.management.remote.JMXConnectorServer
+ * connector servers}.
  *
  * @moduleGraph
  * @since 9