diff options
5 files changed, 373 insertions, 31 deletions
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 000000000..9cbc89dd2 --- /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<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.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 20913d228..1e648a5d2 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.eclipse.osgi.util.ManifestElement; 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 @@ import org.osgi.framework.Constants; * 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 5158f9835..ac4da2ac2 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 @@ import java.util.*; * 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 93bad0bdf..87cece9ff 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 @@ import org.osgi.framework.Constants; * 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 8a8b65d78..b804d60de 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 @@ package org.eclipse.core.runtime; * 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 { |