--- old/jdk/src/jdk.jartool/share/classes/module-info.java	2017-06-06 22:43:53.000000000 -0700
+++ new/jdk/src/jdk.jartool/share/classes/module-info.java	2017-06-06 22:43:52.000000000 -0700
@@ -25,7 +25,25 @@
 
 /**
  * Defines tools for manipulating Java Archive (JAR) files,
- * including the jar and jarsigner tools.
+ * including the <em>{@index jar jar}</em> and 
+ * <em>{@index jarsigner jarsigner}</em> tools.
+ *
+ * <p> This module provides the equivalent of command-line access to 
+ * <em>jar</em> via the {@link java.util.spi.ToolProvider ToolProvider} SPI.
+ *
+ * <p> Instances of the tool can be obtained by calling 
+ * {@link java.util.spi.ToolProvider#findFirst ToolProvider.findFirst} 
+ * or the {@link java.util.ServiceLoader service loader} with the name 
+ * {@code "jar"}.
+ *
+ * <p> <em>jarsigner</em> just exists as a command line tool,
+ * and does not provide any direct API.
+ *
+ * <dl style="font-family:'DejaVu Sans', Arial, Helvetica, sans serif">
+ * <dt class="simpleTagLabel">Tool Guides:
+ * <dd>{@extLink jar_tool_reference jar},
+ *     {@extLink jarsigner_tool_reference jarsigner}
+ * </dl>
  *
  * @moduleGraph
  * @since 9