From dac48cc2b6c2dc09855964b25ac835d845a25028 Mon Sep 17 00:00:00 2001
From: Hannes Wellmann <wellmann.hannes1@gmx.net>
Date: Sat, 4 Nov 2023 17:07:41 +0100
Subject: [PATCH] Add deprecation notice for javax support by the E4 injector

Part of https://github.com/eclipse-platform/eclipse.platform.releng.aggregator/issues/1056
---
 .../porting/removals.html                     | 30 +++++++++++++++----
 1 file changed, 25 insertions(+), 5 deletions(-)

diff --git a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/removals.html b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/removals.html
index 98819becb23..ed33eaad71c 100644
--- a/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/removals.html
+++ b/eclipse.platform.common/bundles/org.eclipse.platform.doc.isv/porting/removals.html
@@ -61,10 +61,8 @@ <h3 id="auth">1. Platform authorization API</h3>
 </p>
 
 
-
-
-
 <!-- ############################################## -->
+
 <h2>API removals after June 2018</h2>
 
 <h3 id="fullscreen">1. org.eclipse.ui.cocoa.fullscreenWindow</h3>
@@ -86,8 +84,8 @@ <h3 id="fullscreen">1. org.eclipse.ui.cocoa.fullscreenWindow</h3>
 </p>
 
 
-
 <!-- ############################################## -->
+
 <h2>API removals after June 2020</h2>
 
 <h3 id="mpartdescriptor">1. Remove Dirtable flag from MPartDescriptor</h3>
@@ -114,6 +112,8 @@ <h3 id="ui-dialogs">2. Remove deprecated dialogs from org.eclipse.ui.dialogs</h3
 </p>
 
 
+<!-- ############################################## -->
+
 <h2>API removals after March 2021</h2>
 
 <h3 id="commandsutil">1. org.eclipse.core.commands.util package</h3>
@@ -133,8 +133,8 @@ <h3 id="equinoxlauncher">3. org.eclipse.core.launcher#Main and WebStartMain and
 </p>
 
 
-
 <!-- ############################################## -->
+
 <h2>API removals after June 2021</h2>
 
 <h3 id="commands">1. Delete deprecated contents of org.eclipse.ui.commands package</h3>
@@ -173,7 +173,9 @@ <h3 id="commands">1. Delete deprecated contents of org.eclipse.ui.commands packa
 For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=431177" target="_blank">bug 431177</a>.
 </p>
 
+
 <!-- ############################################## -->
+
 <h2>API removals after May 2022</h2>
 
 <h3 id="sharedImages">1. Hover images from ISharedImages</h3>
@@ -197,6 +199,9 @@ <h3 id="sharedImages">1. Hover images from ISharedImages</h3>
 For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=559593" target="_blank">bug 559593</a>.
 </p>
 
+
+<!-- ############################################## -->
+
 <h2>API removals after June 2022</h2>
 
 <h3 id="icu4j">1. ICU4J bundle from SDK</h3>
@@ -206,7 +211,9 @@ <h3 id="icu4j">1. ICU4J bundle from SDK</h3>
 For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=562582" target="_blank">bug 562582</a>.
 </p>
 
+
 <!-- ############################################## -->
+
 <h2>API removals after September 2022</h2>
 
 <h3 id="observablefactories">1. Observable factory classes</h3>
@@ -247,6 +254,19 @@ <h3 id="IModelProviderEvent">4. Remove IModelProviderEvent's fields TARGET_CHANG
 <h1 id="removed">Removed API in previous releases</h1>
 
 
+<!-- ############################################## -->
+
+<h2>API removals after December 2025</h2>
+
+<h3 id="javax-annotations">1. Support for javax-annotation by the E4 Injector</h3>
+
+The support of the Eclipse E4 Platform Dependency Injector for annotations from the <code>javax.inject</code> and <code>javax.annotation</code> package is deprecated
+and scheduled to be disabled by default after the December 2026 release and scheduled for removal after the December 2028 release.
+<p>
+Processing of <code>javax</code> annotations can be disabled for an application already now by specifying the VM property <code>-Declipse.e4.inject.javax.disabled=true</code>.
+For further details or to provide feedback on this change, see <a href="https://github.com/eclipse-platform/eclipse.platform.releng.aggregator/issues/1056">eclipse.platform.releng.aggregator#1056</a>.
+</p>
+
 <hr>
 <!-- ############################################## -->