Marked long-time deprecated API in Plugin for removal

Plugin contains methods which are marked since a long time as
deprecated. Marking these for removal to give us the flexibility to
remove these after API freeze period if needed.

Triggered by an investigation of ILegacyPreferences from Equinox which
calls some of these methods in PreferenceServiceRegistryHelper during
startup.

savePluginPreferences and getPluginPreferences are not yet marked for
deletion as they are still used by the Ant tooling.
d

Author: vogella

runtime/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/Plugin.java

@@ -213,7 +213,7 @@ public Plugin() {
 	 * @return a URL for the given path or <code>null</code>
 	 * @deprecated use {@link FileLocator#find(Bundle, IPath, Map)}
 	 */
-	@Deprecated
+	@Deprecated(forRemoval = true, since = "2025-06 (removal in 2027-06 or later)")
 	public final URL find(IPath path) {
 		return FileLocator.find(getBundle(), path, null);
 	}
@@ -232,7 +232,7 @@ public final URL find(IPath path) {
 	 * @return a URL for the given path or <code>null</code>
 	 * @deprecated use {@link FileLocator#find(Bundle, IPath, Map)}
 	 */
-	@Deprecated
+	@Deprecated(forRemoval = true, since = "2025-06 (removal in 2027-06 or later)")
 	public final URL find(IPath path, Map<String,String> override) {
 		return FileLocator.find(getBundle(), path, override);
 	}
@@ -424,7 +424,7 @@ public final void savePluginPreferences() {
 	 *		}
 	 * </pre>
 	 */
-	@Deprecated
+	@Deprecated(forRemoval = true, since = "2025-06 (removal in 2027-06 or later)")
 	protected void initializeDefaultPluginPreferences() {
 		// default implementation of this method - spec'd to do nothing
 	}
@@ -437,7 +437,7 @@ protected void initializeDefaultPluginPreferences() {
 	 * @since 3.0
 	 * @deprecated
 	 */
-	@Deprecated
+	@Deprecated(forRemoval = true, since = "2025-06 (removal in 2027-06 or later)")
 	public final void internalInitializeDefaultPluginPreferences() {
 		initializeDefaultPluginPreferences();
 	}
@@ -479,7 +479,7 @@ public boolean isDebugging() {
 	 * @see #openStream(IPath,boolean)
 	 * @deprecated use {@link FileLocator#openStream(Bundle, IPath, boolean)}
 	 */
-	@Deprecated
+	@Deprecated(forRemoval = true, since = "2025-06 (removal in 2027-06 or later)")
 	public final InputStream openStream(IPath file) throws IOException {
 		return FileLocator.openStream(getBundle(), file, false);
 	}
@@ -502,7 +502,7 @@ public final InputStream openStream(IPath file) throws IOException {
 	 * @exception IOException if the given path cannot be found in this plug-in
 	 * @deprecated use {@link FileLocator#openStream(Bundle, IPath, boolean)}
 	 */
-	@Deprecated
+	@Deprecated(forRemoval = true, since = "2025-06 (removal in 2027-06 or later)")
 	public final InputStream openStream(IPath file, boolean substituteArgs) throws IOException {
 		return FileLocator.openStream(getBundle(), file, substituteArgs);
 	}
@@ -576,7 +576,7 @@ private DebugOptions getDebugOptions() {
 	 *
 	 * @deprecated
 	 */
-	@Deprecated
+	@Deprecated(forRemoval = true, since = "2025-06 (removal in 2027-06 or later)")
 	public void shutdown() throws CoreException {
 		// intentionally left empty
 	}