src/java.xml/share/classes/com/sun/org/apache/xml/internal/resolver/CatalogManager.java

*** 108,124 ****
   * </tr>
   * </tbody>
   * </table>
   *
   * @see Catalog
   *
   * @author Norman Walsh
   * <a href="mailto:Norman.Walsh@Sun.COM">Norman.Walsh@Sun.COM</a>
   *
   * @version 1.0
   */
! 
  public class CatalogManager {
      private static final String pFiles         = "xml.catalog.files";
      private static final String pVerbosity     = "xml.catalog.verbosity";
      private static final String pPrefer        = "xml.catalog.prefer";
      private static final String pStatic        = "xml.catalog.staticCatalog";
--- 108,132 ----
   * </tr>
   * </tbody>
   * </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";
      private static final String pPrefer        = "xml.catalog.prefer";
      private static final String pStatic        = "xml.catalog.staticCatalog";