Looks like I have a chance to tweak the comments for the JAF changes.
Any final comments before I apply these changes to all 4 copies of
this code?
$ diff -u MailcapCommandMap.java.orig MailcapCommandMap.java
--- MailcapCommandMap.java.orig 2017-03-15 15:10:43.731176917 -0700
+++ MailcapCommandMap.java 2017-03-15 15:15:23.009441462 -0700
@@ -50,16 +50,18 @@
* <ol>
* <li> Programatically added entries to the MailcapCommandMap instance.
* <li> The file {@code .mailcap} in the user's home directory.
- * <li> The file <i>java.home</i>{@code /}<i>conf</i>{@code /mailcap}.
+ * <li> The file {@code mailcap} in the Java runtime.
* <li> The file or resources named {@code META-INF/mailcap}.
* <li> The file or resource named {@code META-INF/mailcap.default}
* (usually found only in the {@code activation.jar} file).
* </ol>
* <p>
- * (Where <i>java.home</i> is the value of the "java.home" System property
- * and <i>conf</i> is the directory named "conf" if it exists,
- * otherwise the directory named "lib"; the "conf" directory was
- * introduced in JDK 1.9.)
+ * (The current implementation looks for the {@code mailcap} file
+ * in the Java runtime in the directory <i>java.home</i>{@code /conf}
+ * if it exists, and otherwise in the directory
+ * <i>java.home</i>{@code /lib}, where <i>java.home</i> is the value
+ * of the "java.home" System property. Note that the "conf" directory was
+ * introduced in JDK 9.)
* <p>
* <b>Mailcap file format:</b><p>
*
$ diff -u MimetypesFileTypeMap.java.orig MimetypesFileTypeMap.java
--- MimetypesFileTypeMap.java.orig 2017-03-15 15:10:54.166714725 -0700
+++ MimetypesFileTypeMap.java 2017-03-15 15:16:11.104610417 -0700
@@ -45,16 +45,18 @@
* <ol>
* <li> Programmatically added entries to the MimetypesFileTypeMap instance.
* <li> The file {@code .mime.types} in the user's home directory.
- * <li> The file <i>java.home</i>{@code /}<i>conf</i>{@code /mime.types}.
+ * <li> The file {@code mime.types} in the Java runtime.
* <li> The file or resources named {@code META-INF/mime.types}.
* <li> The file or resource named {@code META-INF/mimetypes.default}
* (usually found only in the {@code activation.jar} file).
* </ol>
* <p>
- * (Where <i>java.home</i> is the value of the "java.home" System property
- * and <i>conf</i> is the directory named "conf" if it exists,
- * otherwise the directory named "lib"; the "conf" directory was
- * introduced in JDK 1.9.)
+ * (The current implementation looks for the {@code mime.types} file
+ * in the Java runtime in the directory <i>java.home</i>{@code /conf}
+ * if it exists, and otherwise in the directory
+ * <i>java.home</i>{@code /lib}, where <i>java.home</i> is the value
+ * of the "java.home" System property. Note that the "conf" directory was
+ * introduced in JDK 9.)
* <p>
* <b>MIME types file format:</b>
*
