Bug 362335 - Need migration guide for new console

1 files changed, 26 insertions, 0 deletions

diff --git a/bundles/org.eclipse.platform.doc.isv/porting/4.2/incompatibilities.html b/bundles/org.eclipse.platform.doc.isv/porting/4.2/incompatibilities.html
index 070546b8c..83b29ba60 100644
--- a/bundles/org.eclipse.platform.doc.isv/porting/4.2/incompatibilities.html
+++ b/bundles/org.eclipse.platform.doc.isv/porting/4.2/incompatibilities.html
@@ -28,6 +28,7 @@
 	<li><a href="#presentationAPI">Presentation API no longer functional</a></li>
 	<li><a href="#window-advisor">Workbench window advisor can no longer customize window creation</a></li>
 	<li><a href="#jetty">Servlet 3.0 and Jetty 8</a></li>
+	<li><a href="#osgiconsole">Equinox OSGi console no longer built into the Equinox Framework</a></li>
 </ol>
 
 <hr>
@@ -203,5 +204,30 @@ or directly requiring old Jetty 6 packages and bundles, must migrate to the new
 and Jetty 8.
 </p>
 
+<!-- ############################################## -->
+<h2>9. <a name="osgiconsole">Equinox OSGi console no longer built into the Equinox Framework</a></h2>
+<p><strong>What is affected:</strong>Any product or launch configuration that supports the 
+Equinox -console command line option.
+</p>
+<p><strong>Description:</strong>
+The new Equinox console shell is based on Apache Felix Gogo shell and provides features
+upon it. It is decoupled from the framework itself.  The built-in OSGi console
+provided by the Equinox framework (org.eclipse.osgi) is disabled by default.  The
+new Equinox console is now provided by bundles which must be installed in order
+to support the -console option.  The new console supports completely and 
+transparently the traditional Equinox-style commands, and also supports the 
+new Gogo-style commands. It also provides telnet and ssh connectivity.
+</p>
+<p><strong>Action required:</strong>
+In order to use Equinox with the new shell, it is necessary to install along with
+the framework also the console bundle itself - org.eclipse.equinox.console and
+the three Gogo bundles - org.apache.felix.gogo.runtime,
+org.apache.felix.gogo.command, org.apache.felix.gogo.shell.
+A detailed documentation for the new Equinox console is available at
+<a href="../../guide/console_shell.htm"><b>Console Shell</b></a>.
+The old built-in Equinox OSGi console shell may be enabled by specifying
+the following configuration property:
+<pre>  osgi.console.enable.builtin=true</pre>
+</p>
 </body>
 </html>
\ No newline at end of file