Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Eclipse4/KnownIssues/4.0"

(Missing end user features)
(Undo revision 270646 by Briandealwis.gmail.com (Talk))
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The Eclipse SDK 4.0 Early Adopter release is not intended to replace the Eclipse 3.6 SDK for most SDK end-users.  Its primary focus is to allow developers of other Eclipse projects and plug-ins to prepare for a future Eclipse simultaneous release built upon it.  In order to ship an SDK based on new underlying technology, we have had to defer some major features that would normally be expected to appear in an Eclipse SDK release. (See [[Eclipse/Eclipse SDK 4.0 FAQ]] for more info on the purpose/target audience of this release.)
+
{{caution|This page is obsolete|Eclipse 4.0 development concluded in July 2010. See [[Eclipse4]] for details.}}
  
This page summarizes the major features that we have intentionally deferred in order to ship the release, and some discussion about how these features could reappear in a future release based on the 4.x stream.
+
The Eclipse SDK 4.0 Early Adopter release is not intended to replace the Eclipse 3.6 SDK for most SDK end-users. Its primary focus is to allow developers of other Eclipse projects and plug-ins to prepare for a future Eclipse simultaneous release built upon it. In order to ship an SDK based on new underlying technology, we have had to defer some major features that would normally be expected to appear in an Eclipse SDK release. (See [[Eclipse4/Eclipse SDK 4.0 FAQ]] for more info on the purpose/target audience of this release.)
  
This list is not intended to be an exhaustive list of missing end-user features, but rather a guide to the "big picture" items that don't appear and why.  Bugzilla remains the best way to see all the open bugs.  [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;product=E4;classification=Eclipse This query] can produce an open bug list.
+
This page summarizes the major features that we have intentionally deferred in order to ship the release, and some discussion about how these features could reappear in a future release based on the 4.x stream.  
  
== Missing API/Developer functionality ==
+
This list is not intended to be an exhaustive list of missing end-user features, but rather a guide to the "big picture" items that don't appear and why. Bugzilla remains the best way to see all the open bugs. [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;product=E4;classification=Eclipse This query] can produce an open bug list.  
As a plug-in developer, you will notice immediately some missing developer-level functionality.  (Of course these omissions imply corresponding missing user functionality, but we focus on the developer view of them).
+
  
* All '''API''' is provisional. Since the purpose of the 4.0 release is to get a wider community adopting the technology, we are leaving ourselves an additional release to get the API right, based on developer feedback.
+
== Rough edges ==
* '''NLS''' support for model files.  {{bug|306576}}
+
* '''Bidi''' support
+
* '''Capabilities''' are not supported.  {{bug|319865}}.  UI will appear whether the capability is enabled or not.
+
* '''Accessibility''' testing has not been done.
+
* Extension point incompatibilities.  Some aspects of the Eclipse 3.x UI extension points are not yet supported by the SDK compatibility layer.  See the individual bugs in question for more detail.
+
** View content descriptors do not appear.  {{bug|320252}}. 
+
** Toolbar button ordering can be different than in 3.x for some action set contributions.  {{bug|319704}}.
+
** No e4 equivalent for popup menu contributions.
+
  
== Missing end user features ==
+
Anyone using the Eclipse SDK 4.0 extensively for development will notice some rough edges in this release. Although the release is completely functional for self-hosted development, and the development team has been using it productively for some time now, there are some notable problems you should be aware of. These problems are also listed in the [http://www.eclipse.org/eclipse/development/readme_eclipse_4.0.html#I-General-EarlyAdopter Eclipse SDK 4.0 Release Notes]:
In some cases, end-user features that exist in 3.6 have been removed or otherwise limited in scope to allow us time to reevaluate how they should be presented in light of new e4 technology.
+
  
* '''Intro'''. The Intro (Welcome view) is not shown on the start of a fresh workspace. We will need to address the intro management differently in 4.0 than in 3.6. Since this release is targetted at current eclipse developers the expectation is that not having this functionality won't be a major issue.
+
=== Known issues that prevent startup ===
* '''Key bindings UI'''.  In SDK 4.0, the user must edit the workbench model description to add or change key bindings.  This proves the viability of adding key bindings to a modeled workbench.  However, the bindings are not persisted.  And of course we don't expect this to be the way that end-users would add bindings.
+
* '''Customize perspective'''.  Given the increased flexibility allowed by a modeled UI, we have not put effort in the 4.0 release into modeling the same perspective functionality as in Eclipse 3.6.  There is no UI for the end-user customizing perspectives.  Future releases will bring perspectives up to par, and likely surpass the capabilities and increase the flexibility of the 3.x perspective model.
+
  
== Incomplete new features ==
+
*In the 4.0 Early Adopter Release, there are circumstances where the model representing the user interface state can become corrupted. This can prevent startup from completing, or cause the user interface to start in a non-functioning state. In this situation, restarting with the -clearPersistedState command line argument will cause the user interface state to be discarded. The user interface will then start normally but will revert to the default perspective and layout.
* The '''e4 modeled UI''' architecture allows far more flexibility than before in defining the layout and composition of a UI. Things that were not possible in the Eclipse 3.x stream, such as mixing views and editors in stacks, choosing to share or not share editor areas in a perspective, or ignoring the perspective model completely, are possible now on the new architecture. We believe it's an entirely new UI design problem to incorporate this flexibility in the SDK workbench, and one that should not be undertaken lightly. Rather than expose all the flexibility of the underlying model, we have largely retained the 3.x perspective model, but do allow users to '''mix views and editors''' in a single part stack. There are limitations and design issues that we haven't worked through yet, but we've chosen to expose the flexibility in order to get some feedback about how it should work. We expect RCP developers to further push the envelope here in the 4.0 time-frame, and will reevaluate the use of perspectives and other model issues in a future release.
+
*Eclipse SDK 4.0 fails to start when proxy passwords have been saved in the global secure storage area by a previous version of Eclipse. The workaround is to clear or move the secure storage area prior to first launch of Eclipse SDK 4.0. See {{bug|320932}} for further details on the bug and workaround.
* A new '''search box''' in the 4.0 SDK gives the user access to the "quick access" feature of Eclipse 3.6. Future releases will evolve this box to a more generic search. {{bug|304440}}.
+
 
 +
=== Memory leaks ===
 +
 
 +
There are some known memory leaks in this release. Running the SDK for long periods will generally cause memory usage to continue increasing. Periodic restarts may be required to recover memory when the SDK is used extensively. For details, see {{bug|320887}} and {{bug|320857}}.
 +
 
 +
=== Widget disposed errors in the log during shutdown ===
 +
 
 +
There are circumstances where "widget is disposed" errors are printed to the log during shutdown. These are caused by bugs in user interface cleanup and generally don't affect subsequent sessions. See {{bug|320854}} and {{bug|319847}} for details.
 +
 
 +
=== Changing theme does not update all widgets dynamically ===
 +
 
 +
When changing to a different them on the General > Appearance preference page, some changes to the appearance only take effect after a restart. See {{bug|321050}} for details.
 +
 
 +
<br>
 +
 
 +
== Missing end user features  ==
 +
 
 +
In some cases, end-user features that exist in 3.6 have been removed or otherwise limited in scope to allow us time to reevaluate how they should be presented in light of new e4 technology.
 +
 
 +
*'''Intro'''. The Intro (Welcome view) is not shown on the start of a fresh workspace. We will need to address the intro management differently in 4.0 than in 3.6. Since this release is targetted at current eclipse developers the expectation is that not having this functionality won't be a major issue.
 +
*There is no updated user documentation. While most user documentation from previous releases is still valid, screenshots have not been globally updated to reflect the new look and feel of the 4.0 release.
 +
*'''Key bindings UI'''. In SDK 4.0, the user must edit the workbench model description to add or change key bindings. This proves the viability of adding key bindings to a modeled workbench. However, the bindings are not persisted. And of course we don't expect this to be the way that end-users would add bindings.
 +
*'''Customize perspective'''. Given the increased flexibility allowed by a modeled UI, we have not put effort in the 4.0 release into modeling the same perspective functionality as in Eclipse 3.6. There is no UI for the end-user customizing perspectives. Future releases will bring perspectives up to par, and likely surpass the capabilities and increase the flexibility of the 3.x perspective model. {{bug|320478}}
 +
 
 +
== Incomplete new features ==
 +
 
 +
*The '''e4 modeled UI''' architecture allows far more flexibility than before in defining the layout and composition of a UI. Things that were not possible in the Eclipse 3.x stream, such as mixing views and editors in stacks, choosing to share or not share editor areas in a perspective, or ignoring the perspective model completely, are possible now on the new architecture. We believe it's an entirely new UI design problem to incorporate this flexibility in the SDK workbench, and one that should not be undertaken lightly. Rather than expose all the flexibility of the underlying model, we have largely retained the 3.x perspective model, but do allow users to '''mix views and editors''' in a single part stack. There are limitations and design issues that we haven't worked through yet, but we've chosen to expose the flexibility in order to get some feedback about how it should work. We expect RCP developers to further push the envelope here in the 4.0 time-frame, and will reevaluate the use of perspectives and other model issues in a future release.  
 +
*A new '''search box''' in the 4.0 SDK gives the user access to the "quick access" feature of Eclipse 3.6. Future releases will evolve this box to a more generic search. {{bug|304440}}.
 +
 
 +
== Missing API/Developer functionality  ==
 +
 
 +
As a plug-in developer, you will notice immediately some missing developer-level functionality. (Of course these omissions imply corresponding missing user functionality, but we focus on the developer view of them).
 +
 
 +
*All '''API''' is provisional. Since the purpose of the 4.0 release is to get a wider community adopting the technology, we are leaving ourselves an additional release to get the API right, based on developer feedback.
 +
 
 +
*There is no '''NLS''' support for model files. This means Eclipse SDK 4.0 cannot be fully internationalized or translated. {{bug|306576}}
 +
*There is no updated plug-in developer documentation.
 +
*'''Bidi''' support.
 +
*'''Capabilities''' are not supported. {{bug|319865}}. UI will appear whether the capability is enabled or not.
 +
*'''Accessibility''' testing has not been done.
 +
*'''Extension point incompatibilities'''. Some aspects of the Eclipse 3.x UI extension points are not yet supported by the SDK compatibility layer. See the individual bugs in question for more detail.
 +
**View content descriptors do not appear. {{bug|320252}}.
 +
**Toolbar button ordering can be different than in 3.x for some action set contributions. {{bug|319704}}.
 +
**No e4 equivalent for popup menu contributions.

Latest revision as of 14:58, 29 September 2011

Stop.png
This page is obsolete
Eclipse 4.0 development concluded in July 2010. See Eclipse4 for details.


The Eclipse SDK 4.0 Early Adopter release is not intended to replace the Eclipse 3.6 SDK for most SDK end-users. Its primary focus is to allow developers of other Eclipse projects and plug-ins to prepare for a future Eclipse simultaneous release built upon it. In order to ship an SDK based on new underlying technology, we have had to defer some major features that would normally be expected to appear in an Eclipse SDK release. (See Eclipse4/Eclipse SDK 4.0 FAQ for more info on the purpose/target audience of this release.)

This page summarizes the major features that we have intentionally deferred in order to ship the release, and some discussion about how these features could reappear in a future release based on the 4.x stream.

This list is not intended to be an exhaustive list of missing end-user features, but rather a guide to the "big picture" items that don't appear and why. Bugzilla remains the best way to see all the open bugs. This query can produce an open bug list.

Rough edges

Anyone using the Eclipse SDK 4.0 extensively for development will notice some rough edges in this release. Although the release is completely functional for self-hosted development, and the development team has been using it productively for some time now, there are some notable problems you should be aware of. These problems are also listed in the Eclipse SDK 4.0 Release Notes:

Known issues that prevent startup

  • In the 4.0 Early Adopter Release, there are circumstances where the model representing the user interface state can become corrupted. This can prevent startup from completing, or cause the user interface to start in a non-functioning state. In this situation, restarting with the -clearPersistedState command line argument will cause the user interface state to be discarded. The user interface will then start normally but will revert to the default perspective and layout.
  • Eclipse SDK 4.0 fails to start when proxy passwords have been saved in the global secure storage area by a previous version of Eclipse. The workaround is to clear or move the secure storage area prior to first launch of Eclipse SDK 4.0. See bug 320932 for further details on the bug and workaround.

Memory leaks

There are some known memory leaks in this release. Running the SDK for long periods will generally cause memory usage to continue increasing. Periodic restarts may be required to recover memory when the SDK is used extensively. For details, see bug 320887 and bug 320857.

Widget disposed errors in the log during shutdown

There are circumstances where "widget is disposed" errors are printed to the log during shutdown. These are caused by bugs in user interface cleanup and generally don't affect subsequent sessions. See bug 320854 and bug 319847 for details.

Changing theme does not update all widgets dynamically

When changing to a different them on the General > Appearance preference page, some changes to the appearance only take effect after a restart. See bug 321050 for details.


Missing end user features

In some cases, end-user features that exist in 3.6 have been removed or otherwise limited in scope to allow us time to reevaluate how they should be presented in light of new e4 technology.

  • Intro. The Intro (Welcome view) is not shown on the start of a fresh workspace. We will need to address the intro management differently in 4.0 than in 3.6. Since this release is targetted at current eclipse developers the expectation is that not having this functionality won't be a major issue.
  • There is no updated user documentation. While most user documentation from previous releases is still valid, screenshots have not been globally updated to reflect the new look and feel of the 4.0 release.
  • Key bindings UI. In SDK 4.0, the user must edit the workbench model description to add or change key bindings. This proves the viability of adding key bindings to a modeled workbench. However, the bindings are not persisted. And of course we don't expect this to be the way that end-users would add bindings.
  • Customize perspective. Given the increased flexibility allowed by a modeled UI, we have not put effort in the 4.0 release into modeling the same perspective functionality as in Eclipse 3.6. There is no UI for the end-user customizing perspectives. Future releases will bring perspectives up to par, and likely surpass the capabilities and increase the flexibility of the 3.x perspective model. bug 320478

Incomplete new features

  • The e4 modeled UI architecture allows far more flexibility than before in defining the layout and composition of a UI. Things that were not possible in the Eclipse 3.x stream, such as mixing views and editors in stacks, choosing to share or not share editor areas in a perspective, or ignoring the perspective model completely, are possible now on the new architecture. We believe it's an entirely new UI design problem to incorporate this flexibility in the SDK workbench, and one that should not be undertaken lightly. Rather than expose all the flexibility of the underlying model, we have largely retained the 3.x perspective model, but do allow users to mix views and editors in a single part stack. There are limitations and design issues that we haven't worked through yet, but we've chosen to expose the flexibility in order to get some feedback about how it should work. We expect RCP developers to further push the envelope here in the 4.0 time-frame, and will reevaluate the use of perspectives and other model issues in a future release.
  • A new search box in the 4.0 SDK gives the user access to the "quick access" feature of Eclipse 3.6. Future releases will evolve this box to a more generic search. bug 304440.

Missing API/Developer functionality

As a plug-in developer, you will notice immediately some missing developer-level functionality. (Of course these omissions imply corresponding missing user functionality, but we focus on the developer view of them).

  • All API is provisional. Since the purpose of the 4.0 release is to get a wider community adopting the technology, we are leaving ourselves an additional release to get the API right, based on developer feedback.
  • There is no NLS support for model files. This means Eclipse SDK 4.0 cannot be fully internationalized or translated. bug 306576
  • There is no updated plug-in developer documentation.
  • Bidi support.
  • Capabilities are not supported. bug 319865. UI will appear whether the capability is enabled or not.
  • Accessibility testing has not been done.
  • Extension point incompatibilities. Some aspects of the Eclipse 3.x UI extension points are not yet supported by the SDK compatibility layer. See the individual bugs in question for more detail.
    • View content descriptors do not appear. bug 320252.
    • Toolbar button ordering can be different than in 3.x for some action set contributions. bug 319704.
    • No e4 equivalent for popup menu contributions.

Copyright © Eclipse Foundation, Inc. All Rights Reserved.