Adding documentation - platform migration doc for Neon (4.6)

1 files changed, 35 insertions, 133 deletions

diff --git a/bundles/org.eclipse.platform.doc.isv/porting/removals.html b/bundles/org.eclipse.platform.doc.isv/porting/removals.html
index 57c0406b5..f93df4b26 100644
--- a/bundles/org.eclipse.platform.doc.isv/porting/removals.html
+++ b/bundles/org.eclipse.platform.doc.isv/porting/removals.html
@@ -24,43 +24,33 @@
 </p>
 
 <p>
-Removed APIs in the Mars (4.5) release:
+Removed APIs in the Neon (4.6) release:
 </p>
-<ol>
- <li><a href="#presentation">Workbench presentation API</a></li>
- <li><a href="#eclipse2view">Eclipse 2.0 ICompatibleWorkbenchPage</a></li>
- <li><a href="#compositeBundles">Composite Bundles</a></li>
- <li><a href="#batchBundleEvent">Batch Bundle Event</a></li>
- <li><a href="#cssextensions">Remove deprecated CSS extension points</a></li>
- <li><a href="#equinoxp2ql">Remove unimplemented interface org.eclipse.equinox.p2.ql</a>
-</ol>
-
+None.
 <p>
-Planned API removals after June 2015:
+Planned API removals after June 2016:
 </p>
 <ol>
+ <li><a href="#listenerlist">org.eclipse.jface.util.ListenerList</a></li>
+ <li><a href="#tabletreeviewer">TableTree and TableTreeViewer</a></li>
  <li><a href="#tasklist">org.eclipse.ui.views.tasklist.TaskList</a></li>
- <li><a href="#runtime">Eclipse 2.0 runtime model and boot API</a></li>
  <li><a href="#auth">Platform authorization API</a></li>
-
+ <li><a href="#runtime">Eclipse 2.0 runtime model and boot API</a></li>
 </ol>
 
 <p>
-Planned API removals after June 2016:
+Planned API removals after June 2017:
 </p>
 <ol>
- <li><a href="#listenerlist">org.eclipse.jface.util.ListenerList</a></li>
- <li><a href="#tabletreeviewer">TableTree and TableTreeViewer</a></li>
+ <li><a href="#imageandmessagearea">ImageAndMessageArea from JFace</a></li>
 </ol>
 
 <p>
-Planned API removals after June 2017:
+Planned API removals after June 2018:
 </p>
 <ol>
  <li><a href="#icontextcomputer">IContextComputer</a></li>
- <li><a href="#iplatformrunnable">org.eclipse.core.boot.IPlatformRunnable</a></li>
 </ol>
-
 <hr>
 
 
@@ -70,105 +60,19 @@ Planned API removals after June 2017:
 
 <h2>API removals in this release</h2>
 
-<h3>1. <a name="presentation">Workbench presentation API</a></h3>
-<p>
-The workbench <i>presentation API</i> allowed plug-ins to override certain aspects of 
-the workbench appearance, such as the shape of view and editor tabs. This mechanism 
-is fundamentally incompatible with the pluggable rendering and declarative styling systems 
-in Eclipse 4.2, which offer applications complete control over all aspects of the workbench 
-layout and style. The following API will be removed:
-</p>
-<ul>
-<li>API package <tt>org.eclipse.ui.presentations</tt></li>
-<li>Extension point <tt>org.eclipse.ui.presentationFactories</tt></li>
-</ul>
-<p>
-For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=370248" target="_blank">bug 370248</a>.
-</p>
-
-<h3>2. <a name="eclipse2view">Eclipse 2.0 ICompatibleWorkbenchPage</a></h3>
-<p>
-Eclipse 4.4 removed the support for Eclipse 2.0 plug-ins. We will therefore remove the <code>ICompatibleWorkbenchPage</code> interface and the <code>org.eclipse.ui.workbench.compatibility</code> plug-in after the Luna release.
-<p>
-For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=431178" target="_blank">bug 431178</a>.
-</p>
+None
 
 <!-- ############################################## -->
 
-<h3>3. <a name="compositeBundles">Composite Bundles</a></h3>
-<p>
-In the Equinox 3.5 release an implementation of an OSGi provisional API was
-included for composite bundles.  This API includes all classes from the
-<code>org.osgi.service.framework package</code>.  This provisional OSGi API has never been
-considered API by Equinox and as such has always been marked as x-internal.
-</p>
-<p>
-The OSGi Alliance has decided to reject this provisional API.  It will never
-become a part of the official OSGi specification.  Any users of the
-<code>org.osgi.service.framework</code> composite bundle API must migrate to using framework
-hooks to provide additional isolation within a single OSGi framework.  See the
-sub-packages of <code>org.osgi.framework.hooks</code> for ways to control
-visibility and isolation for resolution, bundles and services.  Equinox plans to
-remove the <code>org.osgi.service.framework</code> API and composite bundle implementation
-in the Summer of 2012 (after the 3.8 release).
-</p>
-<p>
-Equinox also has a region digraph implementation that allows for the definition
-and configuration of regions that can be used to isolate bundles.  The region
-digraph is built on top of the standard OSGi framework hooks.
-
-The specific API to be removed includes:
-</p>
-<ul>
-
-<li>The complete org.osgi.service.framework package</li>
+<h2>API removals after June 2016</h2>
 
-</ul>
-<p>
-For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=345790" target="_blank">bug 345790</a>.
-</p>
-
-<!-- ############################################## -->
-
-<h3>4. <a name="batchBundleEvent">Batch Bundle Event</a></h3>
-<p>
-Since Eclipse 3.1, the Equinox Framework has provided API to allow bundle
-listeners to batch bundle events.  This functionality never has been
-standardized with OSGi and the approach as several drawbacks that make the
-API difficult to use.  For these and other reasons the API package
-<tt>org.eclipse.osgi.event</tt> will be removed.
-</p>
-<p>
-For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=407302" target="_blank">bug 407302</a>.
-</p>
-
-<h3>5. <a name="cssextensions">Remove deprecated CSS extension points</a></h3>
-<p>
-Since Eclipse 4.0, the Eclipse platform allows styling based on external CSS files.  During the implementation two experimental
-extension points have been created which have been replaced in the meantime.
-
-For this reason the extension points
-<tt>org.eclipse.e4.u.css.core.elementProvider</tt> and <tt>org.eclipse.e4.ui.css.swt.property.handler </tt> will be removed.
-</p>
-<p>
-For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=430638" target="_blank">bug 430638</a>.
-</p>
-
-<h3>6. <a name="equinoxp2ql">Removed unimplemented interface org.eclipse.equinox.p2.ql</a></h3>
-<p>This interface was never implemented, and never used, and "should never have been published" to quote 
-from <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=453228">bug 453228</a>.
-</p>
-
-<!-- ############################################## -->
-
-<h2>API removals after June 2015</h2>
 <h3>1. <a name="listenerlist">org.eclipse.jface.util.ListenerList</a></h3>
 <p>
 The <code>org.eclipse.jface.util.ListenerList</code> class is deprecated since 2005 and has been replaced by <code>org.eclipse.core.runtime.ListenerList with org.eclipse.core.runtime.ListenerList.IDENTITY</code> as argument.
 The <code>org.eclipse.jface.util.ListenerList</code> class is planned to get deleted.
 </p>
 <p>
-For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=431981" target="_blank">bug 431981</a>.
+For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=436448" target="_blank">bug 436448</a>.
 </p>
 
 <h3>2. <a name="tabletreeviewer">TableTreeViewer</a></h3>
@@ -177,7 +81,7 @@ The <code>org.eclipse.jface.viewers.TableTreeViewer</code> class is deprecated s
 The <code>org.eclipse.jface.viewers.TableTreeViewer</code>, <code>org.eclipse.swt.custom.TableTree</code> and <code>org.eclipse.swt.custome.TableTreeItem</code> classes are planned to get deleted as well as methods using these types.
 </p>
 <p>
-For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=434575" target="_blank">bug 434575</a>.
+For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=436505" target="_blank">bug 436505</a>.
 </p>
 
 <h3>3. <a name="tasklist">org.eclipse.ui.views.tasklist.TaskList</a></h3>
@@ -186,32 +90,10 @@ The <code>org.eclipse.ui.views.tasklist.TaskList</code> class is deprecated sinc
 The <code>org.eclipse.ui.views.tasklist.TaskList</code> class and related classes only used by this class are planned to get deleted.
 </p>
 <p>
-For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=434615" target="_blank">bug 434615</a>.
-</p>
-
-<!-- ############################################## -->
-
-<h3>4. <a name="runtime">Eclipse 2.0 runtime model and boot API</a></h3>
-<p>
-When the Eclipse runtime transitioned to use OSGi as its implementation, some existing
-APIs for interacting with the old runtime were deprecated and moved to a compatibility fragment
-(<tt>org.eclipse.core.runtime.compatibility</tt>). All API that was still valid was moved
-elsewhere. These APIs have been non-functional since Eclipse 3.0 and will therefore
-be removed in the future. The following packages will be removed:
-</p>
-<ul>
- <li><tt>org.eclipse.core.boot</tt></li>
- <li><tt>org.eclipse.core.runtime.model</tt></li>
- </ul>
- The compatibility fragment, <tt>org.eclipse.core.runtime.compatibility</tt> will
- also be removed. As a consequence <code>org.eclipse.ui.startup</code> extensions will no longer work if they do not specify a class that implements <code> org.eclipse.ui.IStartup</code>. 
-<p>
-For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=370248" target="_blank">bug 370248</a>.
+For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=436506" target="_blank">bug 436506</a>.
 </p>
 
-<!-- ############################################## -->
-
-<h3>5. <a name="auth">Platform authorization API</a></h3>
+<h3>4. <a name="auth">Platform authorization API</a></h3>
 <p>
 Since Eclipse 1.0, the Eclipse Platform class provided API for storing and retrieving
 passwords in a keyring file. This API used an inherently insecure method for encrypting 
@@ -230,9 +112,29 @@ be removed from <tt>org.eclipse.core.runtime.Platform</tt>:
  <li><tt>getProtectionSpace(URL resourceUrl)</tt></li>
  </ul>
 <p>
+For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=476404" target="_blank">bug 476404</a>.
+</p>
+<h3>5. <a name="runtime">Eclipse 2.0 runtime model and boot API</a></h3>
+<p>
+When the Eclipse runtime transitioned to use OSGi as its implementation, some existing
+APIs for interacting with the old runtime were deprecated and moved to a compatibility fragment
+(<tt>org.eclipse.core.runtime.compatibility</tt>). All API that was still valid was moved
+elsewhere. These APIs have been non-functional since Eclipse 3.0 and will therefore
+be removed in the future. The following packages will be removed:
+</p>
+<ul>
+ <li><tt>org.eclipse.core.boot</tt></li>
+ <li><tt>org.eclipse.core.runtime.model</tt></li>
+ </ul>
+ The compatibility fragment, <tt>org.eclipse.core.runtime.compatibility</tt> will
+ also be removed. As a consequence <code>org.eclipse.ui.startup</code> extensions will no longer work if they do not specify a class that implements <code> org.eclipse.ui.IStartup</code>. 
+<p>
 For further details or to provide feedback on this change, see <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=370248" target="_blank">bug 370248</a>.
 </p>
 
+
+<!-- ############################################## -->
+
 <h2>API removals after June 2017</h2>
 <h3>1. <a name="icontextcomputer">IContextComputer and related classes</a></h3>
 <p>