--- old/jaxws/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/Options.java	2017-02-14 14:26:14.360413401 +0300
+++ new/jaxws/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/Options.java	2017-02-14 14:26:14.260412761 +0300
@@ -181,9 +181,7 @@
     public File targetDir = new File(".");
 
     /**
-     * Actually stores {@link CatalogResolver}, but the field
-     * type is made to {@link EntityResolver} so that XJC can be
-     * used even if resolver.jar is not available in the classpath.
+     * Stores {@link EntityResolver}.
      */
     public EntityResolver entityResolver = null;
 
@@ -639,7 +637,9 @@
             return 2;
         }
         if( args[i].equals("-catalog") ) {
-            // use javax.xml.catalog to resolve external entities.
+            // use Sun's "XML Entity and URI Resolvers" by Norman Walsh
+            // to resolve external entities.
+            // https://xerces.apache.org/xml-commons/components/resolver/resolver-article.html
 
             File catalogFile = new File(requireArgument("-catalog",args,++i));
             try {