Bug 544339 - Mark 2.0 plug-in compatibility classes for deletion

Change-Id: I0a24f2157a3036ccd1cb993e26d08d3de400efa1
Signed-off-by: Lars Vogel <Lars.Vogel@vogella.com>
diff --git a/bundles/org.eclipse.core.runtime/.settings/.api_filters b/bundles/org.eclipse.core.runtime/.settings/.api_filters
new file mode 100644
index 0000000..9cbc89d
--- /dev/null
+++ b/bundles/org.eclipse.core.runtime/.settings/.api_filters
@@ -0,0 +1,313 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<component id="org.eclipse.core.runtime" version="2">
+    <resource path="src/org/eclipse/core/runtime/ILibrary.java" type="org.eclipse.core.runtime.ILibrary">
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="403853384">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.ILibrary"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.ILibrary"/>
+                <message_argument value="getContentFilters()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.ILibrary"/>
+                <message_argument value="getPackagePrefixes()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.ILibrary"/>
+                <message_argument value="getPath()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.ILibrary"/>
+                <message_argument value="getType()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.ILibrary"/>
+                <message_argument value="isExported()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.ILibrary"/>
+                <message_argument value="isFullyExported()"/>
+            </message_arguments>
+        </filter>
+    </resource>
+    <resource path="src/org/eclipse/core/runtime/IPluginDescriptor.java" type="org.eclipse.core.runtime.IPluginDescriptor">
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="403853384">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="find(IPath)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="find(IPath, Map&lt;String,String&gt;)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getExtension(String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getExtensionPoint(String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getExtensionPoints()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getExtensions()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getInstallURL()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getLabel()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getPlugin()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getPluginClassLoader()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getPluginPrerequisites()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getProviderName()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getResourceBundle()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getResourceString(String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getResourceString(String, ResourceBundle)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getRuntimeLibraries()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getUniqueIdentifier()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="getVersionIdentifier()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginDescriptor"/>
+                <message_argument value="isPluginActivated()"/>
+            </message_arguments>
+        </filter>
+    </resource>
+    <resource path="src/org/eclipse/core/runtime/IPluginPrerequisite.java" type="org.eclipse.core.runtime.IPluginPrerequisite">
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="403853384">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="getResolvedVersionIdentifier()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="getUniqueIdentifier()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="getVersionIdentifier()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="isExported()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="isMatchedAsCompatible()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="isMatchedAsEquivalent()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="isMatchedAsExact()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="isMatchedAsGreaterOrEqual()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="isMatchedAsPerfect()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginPrerequisite"/>
+                <message_argument value="isOptional()"/>
+            </message_arguments>
+        </filter>
+    </resource>
+    <resource path="src/org/eclipse/core/runtime/IPluginRegistry.java" type="org.eclipse.core.runtime.IPluginRegistry">
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="403853384">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getConfigurationElementsFor(String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getConfigurationElementsFor(String, String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getConfigurationElementsFor(String, String, String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getExtension(String, String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getExtension(String, String, String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getExtensionPoint(String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getExtensionPoint(String, String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getExtensionPoints()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getPluginDescriptor(String)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getPluginDescriptor(String, PluginVersionIdentifier)"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getPluginDescriptors()"/>
+            </message_arguments>
+        </filter>
+        <filter comment="https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339" id="406052990">
+            <message_arguments>
+                <message_argument value="org.eclipse.core.runtime.IPluginRegistry"/>
+                <message_argument value="getPluginDescriptors(String)"/>
+            </message_arguments>
+        </filter>
+    </resource>
+</component>
diff --git a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/ILibrary.java b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/ILibrary.java
index 20913d2..1e648a5 100644
--- a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/ILibrary.java
+++ b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/ILibrary.java
@@ -17,25 +17,31 @@
 import org.osgi.framework.Constants;
 
 /**
- * A runtime library declared in a plug-in.  Libraries contribute elements to the search path.
- * These contributions are specified as a path to a directory or Jar file.  This path is always
- * considered to be relative to the containing plug-in.
+ * A runtime library declared in a plug-in. Libraries contribute elements to the
+ * search path. These contributions are specified as a path to a directory or
+ * Jar file. This path is always considered to be relative to the containing
+ * plug-in.
  * <p>
- * Libraries are typed.  The type is used to determine to which search path the library's
- * contribution should be added.  The valid types are: <code>CODE</code> and
- * <code>RESOURCE</code>.
+ * Libraries are typed. The type is used to determine to which search path the
+ * library's contribution should be added. The valid types are:
+ * <code>CODE</code> and <code>RESOURCE</code>.
  * </p>
  *
  * @see IPluginDescriptor#getRuntimeLibraries()
- * @deprecated
- * In Eclipse 3.0 the plug-in classpath representation was changed.  Clients of
- * <code>ILibrary</code> are directed to the headers associated with the relevant bundle.
- * In particular, the <code>Bundle-Classpath</code> header contains all available information
- * about the classpath of a plug-in.  Having retrieved the header, the {@link ManifestElement}
- * helper class can be used to parse the value and discover the individual
- * class path entries.  The various header attributes are defined in {@link Constants}.
- * <p>For example,</p>
- * <pre>
+ * @deprecated In Eclipse 3.0 the plug-in classpath representation was changed.
+ *             Clients of <code>ILibrary</code> are directed to the headers
+ *             associated with the relevant bundle. In particular, the
+ *             <code>Bundle-Classpath</code> header contains all available
+ *             information about the classpath of a plug-in. Having retrieved
+ *             the header, the {@link ManifestElement} helper class can be used
+ *             to parse the value and discover the individual class path
+ *             entries. The various header attributes are defined in
+ *             {@link Constants}.
+ *             <p>
+ *             For example,
+ *             </p>
+ *
+ *             <pre>
  *     String header = bundle.getHeaders().get(Constants.BUNDLE_CLASSPATH);
  *     ManifestElement[] elements = ManifestElement.parseHeader(
  *         Constants.BUNDLE_CLASSPATH, header);
@@ -43,20 +49,27 @@
  *         return;
  *     elements[0].getValue();   // the jar/dir containing the code
  *     ...
- * </pre>
- * <p>
- * Note that this new structure does not include information on
- * which packages are exported or present in the listed classpath entries. This
- * information is no longer relevant.
- * </p><p>
- * See {@link IPluginDescriptor} for information on the relationship between plug-in
- * descriptors and bundles.
- * </p><p>
- * This interface must only be used by plug-ins
- * which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
- * </p>
- *
+ *             </pre>
+ *             <p>
+ *             Note that this new structure does not include information on
+ *             which packages are exported or present in the listed classpath
+ *             entries. This information is no longer relevant.
+ *             </p>
+ *             <p>
+ *             See {@link IPluginDescriptor} for information on the relationship
+ *             between plug-in descriptors and bundles.
+ *             </p>
+ *             <p>
+ *             This interface must only be used by plug-ins which explicitly
+ *             require the org.eclipse.core.runtime.compatibility plug-in.
+ *             </p>
+ * @noextend This interface is not intended to be extended by clients.
+ * @noreference This interface is not intended to be referenced by clients.
  * @noimplement This interface is not intended to be implemented by clients.
+ *
+ *              This interface is planned to be deleted, see
+ *              https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339
+ *
  */
 @Deprecated
 public interface ILibrary {
diff --git a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginDescriptor.java b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginDescriptor.java
index 5158f98..ac4da2a 100644
--- a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginDescriptor.java
+++ b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginDescriptor.java
@@ -24,9 +24,13 @@
  * It is not used anymore as Eclipse 4.6 removed this plug-in.
  * </p>
  *
- * @deprecated
- *
+ * @noextend This interface is not intended to be extended by clients.
+ * @noreference This interface is not intended to be referenced by clients.
  * @noimplement This interface is not intended to be implemented by clients.
+ *
+ *              This interface is planned to be deleted, see
+ *              https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339
+ *
  */
 @Deprecated
 public interface IPluginDescriptor {
diff --git a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginPrerequisite.java b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginPrerequisite.java
index 93bad0b..87cece9 100644
--- a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginPrerequisite.java
+++ b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginPrerequisite.java
@@ -47,8 +47,14 @@
  * This interface must only be used by plug-ins
  * which explicitly require the org.eclipse.core.runtime.compatibility plug-in.
  * </p>
- *
+ * 
+ * @noextend This interface is not intended to be extended by clients.
+ * @noreference This interface is not intended to be referenced by clients.
  * @noimplement This interface is not intended to be implemented by clients.
+ *
+ *              This interface is planned to be deleted, see
+ *              https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339
+ *
  */
 @Deprecated
 public interface IPluginPrerequisite {
diff --git a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginRegistry.java b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginRegistry.java
index 8a8b65d..b804d60 100644
--- a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginRegistry.java
+++ b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginRegistry.java
@@ -17,7 +17,13 @@
  * As the org.eclipse.core.runtime.compatibility plug-in has been removed in
  * Eclipse 4.6 this interface is not supported anymore.
  *
+ * @noextend This interface is not intended to be extended by clients.
+ * @noreference This interface is not intended to be referenced by clients.
  * @noimplement This interface is not intended to be implemented by clients.
+ *
+ *              This interface is planned to be deleted, see
+ *              https://bugs.eclipse.org/bugs/show_bug.cgi?id=544339
+ *
  */
 @Deprecated
 public interface IPluginRegistry {