--- old/src/java.xml/share/classes/com/sun/org/apache/xml/internal/resolver/CatalogManager.java	2016-09-14 11:28:12.852263229 -0700
+++ new/src/java.xml/share/classes/com/sun/org/apache/xml/internal/resolver/CatalogManager.java	2016-09-14 11:28:12.772259235 -0700
@@ -110,13 +110,21 @@
  * </table>
  *
  * @see Catalog
+ * @deprecated The JDK internal Catalog API in package
+ * {@code com.sun.org.apache.xml.internal.resolver}
+ * is encapsulated in JDK 9. The entire implementation under the package is now
+ * deprecated and subject to removal in a future release. Users of the API 
+ * should migrate to the {@linkplain javax.xml.catalog new public API}.
+ * <p>
+ * The new Catalog API is supported throughout the JDK XML Processors, which allows
+ * the use of Catalog by simply setting a path to a Catalog file as a property. 
  *
  * @author Norman Walsh
  * <a href="mailto:Norman.Walsh@Sun.COM">Norman.Walsh@Sun.COM</a>
  *
  * @version 1.0
  */
-
+@Deprecated(since="9", forRemoval=true)
 public class CatalogManager {
     private static final String pFiles         = "xml.catalog.files";
     private static final String pVerbosity     = "xml.catalog.verbosity";