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 pages "Rich Client Platform/FAQ" and "Polish3.2"

< Rich Client Platform(Difference between pages)
(What is the recommended target platform setup? Or: How can I build and run my RCP app against a different version of the Eclipse base?)
 
 
Line 1: Line 1:
Eclipse Rich Client Platform FAQ
+
<h1>3.2 Polish Items<br>
 
+
</h1>
The following are '''Frequently Asked Questions''' ('''FAQs''') about the Eclipse Rich Client Platform.
+
<p><small><i>Last update: March 15, 2006 (Changes since March 13, 2006 in <font
For relevant tutorials, help topics, newsgroups, examples, and other resources, see the main [[Rich Client Platform|RCP page]].
+
  color="#33cc00"><b>green</b></font>. New entries in Team and JDT UI)</i><br>
 +
  </small></p>
 +
<p><font color="#00FF00"><strong><em>New additions in green.</em></strong></font></p>
 +
<p><small><font color="#FF0000"><strong>Entries in RED have been fixed.</strong></font></small></p>
 +
<p><strong><font color="#0000FF">Entries in BLUE are not in the plan for 3.2</font></strong></p>
 +
<p><small><br>
 +
  </small> So far, I have received input from the Search, Platform/JDT Text, JDT
 +
  Core, JDT UI, and Debug teams. This document contains a summary of that feedback.
 +
  The items are listed by component, but are otherwise in no particular order.
 +
  <br>
 +
</p>
 +
<h2>General / All</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 +
 
 +
    <tr>
 +
      <th width="10%">Bugzilla</th>
 +
      <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%"></td>
 +
      <td>Do we need a new splash screen? <em><strong><font color="#00FF00">MVM asking designers to investigate in light of new welcome as well.</font></strong></em></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%"></td>
 +
      <td>Update keywords for searching preference pages. I.e. verify that all the new preferences are covered.</td>
 +
    </tr>
 +
</table>
 +
<br>
 +
<h2>Platform Runtime</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 +
    <tr>
 +
      <th width="10%">Bugzilla</th>
 +
      <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=128178 128178]</td>
 +
      <td>[Workbench] earlyStartup does not work in runtime eclipse with binary-imported plugins</td>
 +
    </tr>
 +
</table>
  
For general Eclipse FAQs, which address many RCP issues, see [[The Official Eclipse FAQs]].
+
<h2>Platform Compare</h2>
 
+
<table border="1" cellpadding="2" cellspacing="2" width="100%">
<div id="whatis"/>
+
    <tr>
==What is the Eclipse Rich Client Platform?==
+
       <th width="10%">Bugzilla</th>
:While the Eclipse platform is designed to serve as an open tools platform, it is architected so that its components could be used to build just about any client application. The minimal set of plug-ins needed to build a rich client application is collectively known as the '''Rich Client Platform'''. 
+
       <th>Description</th>
:For more details, see the main [[Rich Client Platform|RCP page]].
+
:Also note that Part 1 of the original [http://eclipse.org/whitepapers/eclipse-overview.pdf Eclipse whitepaper] also applies, and is a good high-level overview of what is available in the Rich Client Platform. Although it speaks of the Eclipse IDE (which is itself an RCP application), almost all of the functionality described in Part 1 is available in the RCP. Exceptions are the Workspace model and Team support, which are components in the IDE, not the RCP. Part 2's discussion of JDT is specific to the Eclipse IDE, however it is a good illustration of how an application would be structured on top of the RCP.
+
 
+
<div id="contents"/>
+
==What is included in the Rich Client Platform?==
+
:The Eclipse Rich Client Platform consists of the following components:
+
<table style="width: 100%; text-align: left;" border="1" cellpadding="2" cellspacing="2">
+
<tr><th>Component<br>
+
       </th>
+
      <th>Description<br>
+
      </th>
+
       <th>Plug-ins<br>
+
      </th>
+
      <th>Documentation<br>
+
      </th>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Eclipse Runtime<br>
+
       <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=78063 78063]</td>
      </td>
+
      <td>Full Javadoc line selected even though only a character has been added to a word</td>
      <td>Provides the foundational support for plug-ins, extension points and
+
extensions (among other facilities).&nbsp; The Eclipse runtime is built on
+
top of the [http://osgi.org/osgi_technology OSGi framework].
+
      </td>
+
      <td>org.eclipse.core.runtime<br>
+
org.eclipse.osgi<br>
+
org.eclipse.osgi.services</td>
+
      <td>[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-core-home/main.html Platform Core home page]<br>
+
Dev guide: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/runtime.htm Runtime overview]<br>
+
Article: [http://eclipse.org/articles/Article-Plug-in-architecture/plugin_architecture.html Notes on the Eclipse Plug-in Architecture]<br>
+
      </td>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>SWT<br>
+
       <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=68758 68758]
      </td>
+
      <td>The Standard Widget Toolkit. SWT is designed to provide efficient, portable access to the user-interface facilities of the operating systems on which it is implemented
+
      </td>
+
      <td>org.eclipse.swt<br>
+
+ platform-specific fragments<br>
+
      </td>
+
      <td>[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/main.html Platform SWT home page]<br>
+
Dev guide: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/swt.htm SWT]<br>
+
[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/SWT_Resources.html Getting Started]<br>
+
[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html SWT FAQ]<br>
+
[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/dev.html#snippets SWT code snippets]<br>
+
[http://eclipse.org/articles/main.html#SWT SWT Articles]
+
 
       </td>
 
       </td>
 +
      <td>Structured Compare: selected added element not part of selection</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>JFace<br>
+
       <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=128362 128362]</td>
       </td>
+
       <td>[Patch] Creating patch from compare in between versions/revisions</td>
       <td>A UI framework, layered on top of SWT, for handling many common UI programming tasks.
+
    </tr>
       </td>
+
    <tr>
       <td>org.eclipse.jface
+
       <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=118021 118021]</td>
      </td>
+
       <td>Structured compare not available with additions or deletions</td>
       <td>[[JFace]]
+
    </tr>
 +
    <tr>
 +
       <td><p> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=112661 <font color="#00FF00">112661</font>]
 +
          (bugs logged by mvm previously)</p>
 +
        <p><font color="#00FF00"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=132693 132693]</font></p></td>
 +
       <td>Cleanup UI of Create/Apply Patch wizards (follow Eclipse UI guidelines):<br>
 +
      <ul>
 +
        <li>button sizes</li>
 +
        <li>caption</li>
 +
        <li>margins</li>
 +
        <li>mnemonics (missing)</li>
 +
        <li>polish all descriptions and messages</li>
 +
        <li>Match Project... button launches dialog called Retarget
 +
        Patch (inconsistent)</li>
 +
      </ul>
 
       </td>
 
       </td>
 
     </tr>
 
     </tr>
 +
 
 +
</table>
 +
<br>
 +
<ul></ul>
 +
<h2>Platform CVS</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 +
    <tr>
 +
      <th width="10%">Bugzilla</th>
 +
      <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%"><strong><font color="#FF0000">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=112927 112927]</font></strong></td>
 +
      <td><strong><font color="#FF0000">[performance] Update CVS workspace job takes too long</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td></td>
 +
      <td>See also " [#too_may_password">too many passwords]" in the Platform UI section below.</td>
 +
    </tr>
 +
</table>
 +
<br>
 +
<h2>Platform Help</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 
     <tr>
 
     <tr>
       <td>Workbench</td>
+
      <th width="10%">Bugzilla</th>
       <td>The Workbench builds on top of the Runtime, SWT and JFace to provide a highly scalable, open-ended, multi-window environment for managing views, editors, perspectives (task-oriented layouts), actions, wizards, preference pages, and more. <br>
+
      <th>Description</th>
The Workbench is sometimes called the Generc Workbench, to distinguish it from the IDE Workbench facilities defined in the org.eclipse.ui.ide plug-in.
+
    </tr>
      </td>
+
    <tr>
      <td>org.eclipse.ui<br>
+
       <td align="right" width="10%"></td>
org.eclipse.ui.workbench
+
       <td>New help support should be improved (2 votes):<br>
 +
      <ul>
 +
        <li>Help button should be on the side where the help shows up. Should stay pushed, and a release should close the help view again</li>
 +
        <li>dialogs without help should better not get the help button</li>
 +
        <li>clicking on a link should directly open the help browser as the space next to the dialog is always too small</li>
 +
      </ul>
 
       </td>
 
       </td>
       <td>[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-ui-home/main.html Platform UI home page]<br>
+
    </tr>
Dev guide: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/workbench.htm Plugging into the workbench],[http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/dialogs.htm  Dialogs and wizards], [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/wrkAdv.htm Advanced workbench concepts]<br>
+
 
[http://eclipse.org/articles/main.html#ui Workbench and JFace Articles]<br>
+
</table>
 +
<br>
 +
<h2>Platform SWT</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 +
    <tr>
 +
      <th width="10%">Bugzilla</th>
 +
      <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
       <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=95634 95634]</td>
 +
      <td>[Tree] TreeColumn does not show "..." on cut-off Text and misses tooltips</td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%"></td>
 +
      <td>I know I'm dreaming, but: styled ranges inside a tree item (Font/colors etc for e.g. a word inside the full label) would be a boost</td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=125702 125702]</td>
 +
      <td><font color="#000000">If you collapse a tree on a recent version of GTK+, a big block of whitespace appears at the bottom. It's very irritating.</font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"><p> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=123425 123425]</p>
 +
        <p> [https://bugs.freedesktop.org/show_bug.cgi?id=5200 5200]</p></td>
 +
      <td><font color="#000000">There's also the &quot;festival of carets&quot; bug. This is immediately noticeable to        anyone using a recent GTK+, and it makes us look bad. Unfortunately, it appears to be a bug somewhere in the Cairo/Pango/glib/GTK+ stack specific to the FPU mode (which the Java VM modifies on start-up). This bug is bad and will be hard to track down. We need to do work if we want to see this fixed; we can't just say &quot;It's their problem&quot;.</font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"></td>
 +
      <td>&nbsp;</td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"></td>
 +
      <td>&nbsp;</td>
 +
    </tr>
 +
 
 +
</table>
 +
<br>
 +
<h2>Platform Team</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 +
 
 +
    <tr>
 +
      <th width="10%">Bugzilla</th>
 +
      <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
      <td></td>
 +
      <td>Need a general polish pass on new History view filtering and user interactions. The bugs below are examples...</td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=125860 125860]</td>
 +
      <td><font color="#FF0000"><strong>New history view: filter is not persisted - no way to constantly ignore local history</strong></font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=129916 129916]</td>
 +
      <td><font color="#FF0000"><strong>Per date sorting in History view forced on me upon ever input change</strong></font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">&nbsp;</td>
 +
      <td><p><font color="#00FF00"><strong>MOVED FROM UI</strong></font></p>
 +
        <p>There are sometimes <a name="too_may_password">]too many password dialogs:<br>
 +
        </p>
 +
        <ul>
 +
          <li>If I'm trying to work off-line but have CVS projects in workspace, it can happen that you get lots of dialogs to ask for the password as the CVS decorators each need that password. Clicking cancel once should be enough to let them know that I'm not interested in entering the password now.</li>
 +
          <li>It would be nice to have a less intrusive way of asking for passwords. Idea is e.g. a status line icon similar to the progress view that blinks when a passwords are pending. Clicking on this icon brings a 'authentication view' that shows that status of all passwords: passed, failed, canceled, and lets me trying to connect again.</li>
 +
        </ul></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=130408 130408]</td>
 +
      <td><font color="#FF0000"><strong>Should be able to export psfs to the workspace
 +
        (2 votes)</strong></font></td>
 +
    </tr>
 +
 
 +
</table>
 +
<br>
 +
<h2>Platform Text</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 +
 
 +
    <tr>
 +
      <th width="10%">Bugzilla</th>
 +
      <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=11624 11624]</td>
 +
      <td><strong><font color="#0000FF">Text Drag and Drop (has many bug votes)</font></strong><br>
 +
      <ul>
 +
        <li>depends on StyledText support ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=106372 NEW - Provide DND support for the StyledText widget 106372]),
 +
        which is now marked as FIXED.</li>
 +
      </ul>
 +
      <p>In order to resolve this we first need to put the grounds for drag and drop contributions
 +
      to editors, otherwise clients contributing some sort of DnD will get broken.
 +
      This is covered in [https://bugs.eclipse.org/bugs/show_bug.cgi?id=125957 bug 125957] and won't make it into 3.2.</p></td>
 +
    </tr>
 +
</table>
 +
<br>
  
       </td>
+
<h2>Platform UI</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 +
 
 +
    <tr>
 +
       <th width="12%">Bugzilla</th>
 +
      <th width="88%">Description</th>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=119890 119890]</td>
 +
      <td> <p><strong><font color="#0000FF">[ViewMgmt] Allow control of view tab compression
 +
          </font></strong></p>
 +
        <p><font color="#000000">- this was changed in 3.2 and need to decide if we like it</font></p></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=100993 100993]</td>
 +
      <td><font color="#000000">[EditorMgmt][Presentations] Regression: Editor tabs do not remember order or active tab after restarting Eclipse</font>
 +
      <p><strong><font color="#00FF00">Investigating</font></strong></p></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=128455 128455]</td>
 +
      <td> <strong><font color="#FF0000">[Presentation] [ViewBar] Outline view toolbar is visible above a maximized editor</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=131559 131559]</td>
 +
      <td> <font color="#FF0000"><strong>[Markers] Layout of marker filters dialog</strong></font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=129936 129936]</td>
 +
      <td><strong><font color="#0000FF">[ViewMgmt] View part description label should wrap</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=125691 125691]</td>
 +
      <td> <font color="#0000FF">[ViewMgmt] Can't read view titles</font></td>
 +
    </tr>
 +
    <tr>
 +
      <td height="38" align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=68684 68684]</td>
 +
      <td><strong><font color="#0000FF"><strong>Remove MRU Ordering from the editors.</strong></font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=113455 113455]</td>
 +
      <td><strong><font color="#FF0000">Some errors do not appear in the Problems view. This happens very frequently for me (multi-processor box, GTK+) if I have grouping turned on.</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=130818 130818]</td>
 +
      <td><strong><font color="#FF0000">Filters do not seem to apply when grouping by Java type (Problems view).<br>
 +
        </font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">&nbsp;</td>
 +
      <td>&nbsp;</td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="12%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=126155 126155]</td>
 +
      <td><font color="#FF0000"><strong>[Markers] Issues of multi quick fix dialog</strong></font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="12%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=122639 122639]</td>
 +
      <td>[WorkbenchParts] PageBookView's toolbar doesn't properly re-layout after page switching</td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=128670 128670]</td>
 +
      <td><font color="#FF0000"><strong>[Dialogs] StatusDialog adds 2 horizontal margins around button bar</strong></font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=127629 127629]</td>
 +
      <td><font color="#FF0000"><strong>[Markers] problems view: keep selection stable</strong></font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=128381 128381], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=128381 128381]</td>
 +
      <td><strong><font color="#FF0000">[Markers] group should only show (10 of 10 items) if beyond the limit</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=129812 129812]</td>
 +
      <td><strong><font color="#FF0000">[Markers] Enabling problem categorization per default</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=129184 129184]</td>
 +
      <td><strong><font color="#FF0000">Progress view should be made more prominent</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=127289 127289]</td>
 +
      <td><strong><font color="#FF0000">[Markers] SystemFilter and group selection
 +
        state not preserved</font></strong></td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>
+
       <td align="right"><strong><font color="#0000FF">see suggestions in bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=109998 109998]</font></strong></td>
Other prerequisites for the Workbench
+
       <td><strong><font color="#0000FF">Experimental (?) Keys preference page (3 votes):<br> <ul>
      </td>
+
          <li>what do we do with the two pages?</li>
       <td>Support for XML expressions language, commands, and help core content model.<br>
+
          <li>sorting by keys, by commands and by scope [https://bugs.eclipse.org/bugs/show_bug.cgi?id=109998 109998]</li>
      </td>
+
          <li>see which keys are free and which commands are not used</li>
      <td>org.eclipse.core.expressions<br>
+
          <li>Platform UI team is investigating what can/can not be done about this without Doug around</li>
org.eclipse.core.commands<br>
+
        </ul></font></strong></td>
org.eclipse.help
+
      </td>
+
      <td><br>
+
      </td>
+
 
     </tr>
 
     </tr>
     </table>
+
     <tr>
 
+
      <td></td>
 +
      <td>Finish the preferences clean up effort from 3.0:<br>
 +
        <ul>
 +
          <li><strong><font color="#FF0000">decorator preference pages should offer a link to decorators</li>
 +
          <li>font / color preferences should use shared settings so it is also possible to configure the color and font decoration for CVS on the CVS page</font></strong></li>
 +
          <li><strong><font color="#00FF00">UI - please provide a bug for this so we can track polish</font></strong></li>
 +
        </ul></td>
 +
    </tr>
 +
    <tr>
 +
      <td></td>
 +
      <td><strong><font color="#0000FF">Improve the look of the filter control (preferences, other dialogs):<br>
 +
        <ul>
 +
          <li>the text field seems unaligned as long as there is no 'clear' button</li>
 +
          <li>either dump the 'clear' button, or add it as a lay-over over the text field:</li>
 +
          <ul>
 +
            <li>For example,&nbsp;in Thunderbird (mozilla mail client), they added a magnifying glass inside the text field (Good visual indication what this field is about) and the clear button ('x', is IMO a better icon than what we have) is inside the text field when applicable. Even better is the help text&nbsp;in light gray.</li>
 +
            <li><strong><font color="#00FF00">UI - please provide a bug for this so we
 +
              can track polish</font></strong></li>
 +
          </ul>
 +
        </ul></font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td></td>
 +
      <td><p>The fast view icon looks like a bug, as the lower right corner is missing. For all the icons on the fast view bar, it isn't obvious what they do. They should be more "inviting" to click on. Maybe some extra adornment in the icon like an arrow that points in the direction they will open. The tooltip should also show the keyboard shortcut.</p>
 +
        <p><strong><font color="#FF0000">New icon is being requested, no other
 +
          work decided at this point</font></strong></p>
 +
        <p><strong><font color="#00FF00">UI - please provide a bug for this so we can
 +
          track polish</font></strong></p></td>
 +
    </tr>
 +
    <tr>
 +
      <td></td>
 +
      <td>&nbsp;</td>
 +
    </tr>
 +
</table>
  
<div id="footprint"/>
+
<h2>JDT Core</h2>
 
+
<table border="1" cellpadding="2" cellspacing="2" width="100%">
==What is the disk footprint for the Rich Client Platform?==
+
:As of Eclipse 3.1.1, the combined disk footprint for the Rich Client Platform, including the above plug-ins, startup.jar and the eclipse.exe executable, is about 6.6 Meg.
+
 
+
 
+
<div id="resourcesPlugin"/>
+
==Is the resources plug-in (org.eclipse.core.resources) considered part of the Rich Client Platform?==
+
:No. The workspace resource model provided by the org.eclipse.core.resources plug-in is not considered part of the Rich Client Platform. While this is the underlying data model for the Eclipse IDE, the RCP makes no assumptions about the underlying data model of the application being built. The data model could just as well be files in the local filesystem, a remote database, an RDF data store, or anything else. If it makes sense for the application, '''org.eclipse.core.resources''' can be included and used as the application's data model, but this is not required. Much effort was put into Eclipse 3.0 to remove the dependencies on '''org.eclipse.core.resources''' from the generic workbench. Any resource dependencies (for example, the New Project, Folder and File wizards, and the Resource Navigator, Tasks and Problems views), were considered IDE-specific and factored out into the IDE plugin ('''org.eclipse.ui.ide''').
+
 
    
 
    
 +
    <tr>
 +
      <th width="10%">Bugzilla</th>
 +
      <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=108087 108087]</td>
 +
      <td><strong><font color="#FF0000">Java conventions default formatter settings
 +
        confused</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=118217 118217]</td>
 +
      <td><p>Change 'unused parameters' warning to only work on private or final methods to avoid false positives.</p></td>
 +
    </tr>
 +
 
 +
</table>
  
<div id="idePlugin"/>
 
==Is the IDE plug-in (org.eclipse.ui.ide) considered part of the Rich Client Platform?==
 
:No.  The '''org.eclipse.ui.ide''' plug-in is layered on top of the generic workbench ('''org.eclipse.ui''') and defines the application for the Eclipse IDE, on top of which sit the other IDE components such as the Java Development Tools (JDT), Plug-in Development Environment (PDE), Debugger, and Team support. The DE instantiates the generic workbench, configuring it with IDE-specific menu and toolbar items, and adding IDE-specific views, preference pages and other extensions. The IDE uses the workspace resource model as its underlying data model.
 
:The org.eclipse.ui.ide plug-in, and the extensions defined within it, are not designed to be reused in other RCP applications.
 
  
<div id="otherComponents"/>
 
==What other Eclipse components can be used in constructing RCP applications?==
 
:Here is a list of some of the reusable components in the broader Eclipse codebase that can be incorporated into RCP applications.
 
  
<table style="width: 100%; text-align: left;" border="1" cellpadding="2" cellspacing="2">
+
<h2>JDT Debug</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 +
 
 +
    <tr>
 +
      <th width="10%">Bugzilla</th>
 +
      <th>Description</th>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%"><strong><font color="#0000FF"> [https://bugs.eclipse.org/bugs/show_bug.cgi?id=128074 128074]</font></strong></td>
 +
      <td><strong><font color="#0000FF">Cannot format stack trace</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=123589 123589]</td>
 +
      <td>Unexpected switch to empty editor when using scrapbook</td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=123588 123588]</td>
 +
      <td>Loosing key binding in scrapbook page</td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=130534 130534]</td>
 +
      <td><strong><font color="#FF0000">add a "collapse all" to the tree's toolbar</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=128558 128558]</td>
 +
      <td>support variables in port and host fields of Remote Java Applications</td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=77125 77125]</td>
 +
      <td><strong><font color="#FF0000">preference for determing how Java breakpoints
 +
        are created - to suspend thread or entire VM</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=125768 125768]</td>
 +
      <td>Support to display breakpoints in rulers of external edtiors:<br> <ul>
 +
          <li>ideally, there would be support for markers in external files from text/platform, but we might be able to do something here <i><b>(not sure how much work this is)</b></i></li>
 +
          <li>since we support breakpoints in external files, and the editor now supports a ruler in external files, we really should make the two work together</li>
 +
        </ul></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=80746 80746]</td>
 +
      <td><font color="#0000FF"><strong>filter exceptions in anonymous classes of X when filtered on X</strong></font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=89474 89474]</td>
 +
      <td><strong><font color="#FF0000">support to edit attributes of multiple archives at once</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=110837 110837]</td>
 +
      <td><strong><font color="#FF0000">properly specify bootpath when launching to avoid problems with crypto applications</font></strong></td>
 +
    </tr>
 +
    <tr>
 +
      <td></td>
 +
      <td>Columns in Variables/Registers view:<br>
 +
        <ul>
 +
          <li>We've added support to the debug platform for columns in debug views</li>
 +
          <li>We want to add support for columns in the java debugger as an optional presentation (we've started this already)</li>
 +
          <li><font color="#00FF00">DEBUG - please provide a bug for this so we can track polish</font></li>
 +
        </ul></td>
 +
    </tr>
 +
    <tr>
 +
      <td></td>
 +
      <td>Undo/Redo:<br>
 +
        <ul>
 +
          <li>We don't currently support undo/redo in the Scrapbook or Display view, which has made a few users angry</li>
 +
          <li><font color="#00FF00">DEBUG - please provide a bug for this so we can track polish</font></li>
 +
        </ul></td>
 +
    </tr>
 +
</table>
 +
<br>
 +
<h2>JDT Text</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 +
 
 
     <tr>
 
     <tr>
       <th>Component<br>
+
       <th width="10%">Bugzilla</th>
      </th>
+
       <th>Description</th>
       <th>Description<br>
+
      </th>
+
      <th>Plug-ins<br>
+
      </th>
+
      <th>Documentation<br>
+
      </th>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Help<br>
+
       <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=95619 95619]</td>
      </td>
+
      <td><strong><font color="#FF0000">[5.0][content assist] Function parameter assist does not work with some parameterized types</font></strong></td>
      <td>Web-app-based Help UI, with support for dynamic content.<br>
+
      </td>
+
      <td>org.eclipse.help.appserver<br>
+
org.eclipse.help.base<br>
+
org.eclipse.help.ui<br>
+
org.eclipse.help.webapp<br>
+
org.eclipse.tomcat<br>
+
org.apache.lucene</td>
+
      <td>[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-help-home/main.html Platform Help home page]<br>
+
Dev guide: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/help.htm Plugging in help]<br>
+
      </td>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Update Manager<br>
+
       <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=92371 92371]</td>
      </td>
+
      <td><strong><font color="#FF0000">[content assist] Parameter guessing could also propose
      <td>Allows users to discover and
+
       expressions for parameters of array types</font></strong></td>
install updated versions of products and extensions.</td>
+
      <td>org.eclipse.update.configurator<br>
+
org.eclipse.update.core<br>
+
org.eclipse.update.scheduler<br>
+
org.eclipse.update.ui<br>
+
+ platform-specific fragments<br>
+
       </td>
+
      <td>[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/main.html Platform Update home page]<br>
+
Dev guide: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/product_update.htm Updating a product or extension]<br>
+
      </td>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Text<br>
+
       <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=41189 41189]</td>
      </td>
+
       <td><strong><font color="#FF0000">[hovering] Editor tooltip size too small
      <td>Framework for building high-function text editors.<br>
+
        for title text (3 votes)</font></strong></td>
      </td>
+
       <td>org.eclipse.text<br>
+
org.eclipse.jface.text<br>
+
org.eclipse.workbench.texteditor</td>
+
      <td>[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-text-home/main.html Platform Text home page]<br>
+
Dev guide: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/editors_jface.htm Text editors and platform text]<br>
+
      </td>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Forms<br>
+
       <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=125677 125677]</td>
      </td>
+
       <td><strong><font color="#FF0000">[navigation] @category not standing out enough in Java Outline view</font></strong></td>
       <td>Flat look control library and multi-page editor framework (used in PDE editors).<br>
+
      </td>
+
      <td>org.eclipse.ui.forms</td>
+
      <td>Article: [http://www.eclipse.org/articles/Article-Forms/article.html Eclipse Forms: Rich UI for the Rich Client]</td>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Welcome Page (aka Intro)</td>
+
       <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=91500 91500]</td>
       <td>Initial welcome experience and guided assistance.<br>
+
       <td><strong><font color="#FF0000">Improve the NLS tooling, especially existing hover and linking features to Eclipse string externalization support (2 votes)</font></strong></td>
      </td>
+
      <td>org.eclipse.ui.intro<br>
+
      </td>
+
      <td>Dev guide: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/workbench_advext_intro.htm Intro support]</td>
+
 
     </tr>
 
     </tr>
 +
 
 +
</table>
 +
<h2>JDT UI</h2>
 +
<table border="1" cellpadding="2" cellspacing="2" width="100%">
 
     <tr>
 
     <tr>
       <td>Cheat Sheets<br>
+
       <th width="10%">Bugzilla</th>
      </td>
+
       <th>Description</th>
       <td>A Cheat Sheet guides the user through a long-running, multi-step task.<br>
+
      </td>
+
      <td>org.eclipse.ui.cheatsheets<br>
+
      </td>
+
      <td>Dev guide: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/workbench_advext_cheatsheets.htm Cheat Sheets]</td>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Resources<br>
+
       <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=129929 129929]</td>
      </td>
+
      <td>IDE no longer responsive when JUnit tests are running</td>
      <td>Workspace resource model, with managed projects, folders and files.<br>
+
      </td>
+
      <td>org.eclipse.core.resources<br>
+
      </td>
+
      <td>[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-core-home/main.html Platform Core home page]<br>
+
Dev guide: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/resInt.htm Resources overview]</td>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Console</td>
+
       <td align="right" width="10%">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=129925 129925]</td>
      <td>Extensible console view.<br>
+
       <td>[JUnit view] Hierarchical+failures should not show more than just failures</td>
      </td>
+
      <td>org.eclipse.ui.console<br>
+
      </td>
+
       <td>Javadoc: [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/console/package-summary.html org.eclipse.ui.console], [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/console/actions/package-summary.html org.eclipse.ui.console.actions]</td>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Outline and Properties views</td>
+
       <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=130106 130106]</td>
      <td>Outline and Properties views<br>
+
       <td><font color="#FF0000">[junit] Hierarchical mode sometimes show testcase in progress
      </td>
+
       and sometimes not</font></td>
       <td>org.eclipse.ui.views<br>
+
       </td>
+
      <td>TBD</td>
+
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Graphical Editing Framework (GEF)</td>
+
       <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=130107 130107]</td>
       <td>Framework for building graphical editors. Includes Draw2D, a vector graphics framework.<br>
+
       <td><font color="#FF0000">[junit view] Hierarchical mode not properly rebuilding the
 +
      tree</font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right" width="10%">
 +
        <p>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=136572 136572]</p>
 +
        <p>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=134078 134078]</p>
 +
        <p>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=134305 134305]</p>
 
       </td>
 
       </td>
       <td>org.eclipse.draw2d<br>
+
       <td>Polish the Clean Up support (2 votes):<br>
org.eclipse.gef<br>
+
        <ul>
      </td>
+
          <li><font color="#FF0000">Clean Up with focus on current file forces me to save other resources? This is particularly annoying when the resource is a text scratch file.</font></li>
      <td>[http://www.eclipse.org/gef GEF home page]<br>
+
          <li><font color="#0000FF">Clean Up should also offer to format the code.</font></li>
[http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/gef-home/overview.html?cvsroot=Tools_Project Overview], [http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/gef-home/developer/faq.html?cvsroot=Tools_Project FAQ]<br>
+
          <li><font color="#FF0000">The wizard needs polish.</font></li>
 +
        </ul>
 
       </td>
 
       </td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Eclipse Modeling Framework (EMF) and Service Data Objects (SDO)</td>
+
       <td></td>
       <td>EMF
+
       <td><p><font color="#0000FF">New Java Perspective (old one becomes the 'Classic Java Perspective')</font></p>
is a modeling framework and code generation facility for building
+
        </td>
tools and other applications based on a structured data model.&nbsp;
+
    </tr>
SDO is a framework that simplifies and unifies data application
+
    <tr>
development in a service oriented arcecture (SOA).</td>
+
 
       <td>[http://dev.eclipse.org/viewcvs/indextools.cgi/org.eclipse.emf/plugins/ EMF plug-in list from CVS]<br>
+
       <td align="right" width="10%">
 +
        <p>[https://bugs.eclipse.org/bugs/show_bug.cgi?id=119259 119259]</p>
 
       </td>
 
       </td>
       <td>[http://www.eclipse.org/emf/ EMF home page]<br>
+
       <td><font color="#FF0000">provide a way to get fully qualified class name into clipboard
Overviews:[http://download.eclipse.org/tools/emf/scripts/docs.php?doc=references/overview/EMF.html EMF], [http://download.eclipse.org/tools/emf/scripts/docs.php?doc=references/overview/EMF.Edit.html EMF.Edit], [http://www-106.ibm.com/developerworks/java/library/j-sdo/ SDO]</td>
+
      </font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=108256 108256]</td>
 +
      <td><font color="#FF0000">[refactoring] [ltk] Refactoring preview does not correctly highlight 5.0 code [refactoring]</font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=122527 122527]</td>
 +
      <td><font color="#0000FF">[build path] Offer a SWT container in JDT</font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=135279 135279]</td>
 +
      <td><font color="#FF0000">[refactoring] improve order of refactoring actions</font></td>
 +
    </tr>
 +
    <tr>
 +
      <td align="right">[https://bugs.eclipse.org/bugs/show_bug.cgi?id=135285 135285]</td>
 +
      <td><font color="#FF0000">[source actions] improve order of source actions</font></td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
 
<div id="gettingStarted"/>
 
 
==How do I get started with RCP?==
 
:The [[Rich Client Platform#tutorials|tutorials]] by Ed Burnette and Jeff Gunther] are good starting points.  See also the [[Rich Client Platform#examples|examples]] and the [[Rich Client Platform#help|suggested help topics]].
 
 
<div id="target"/>
 
==What is the recommended target platform setup?  Or: How can I build and run my RCP app against a different version of the Eclipse base?==
 
:With the default setup of the Eclipse SDK, plug-ins are developed against the same plug-in configuration used by the IDE itself.  However, it is possible to configure the IDE to build, run and deploy against a different version of the eclipse base, via the Plug-in Development > Target Platform preference page.  Configuring the target platform is highly recommended in order to avoid introducing unwanted dependencies on IDE plug-ins into your RCP app.
 
:For more details, see the [http://help.eclipse.org/help31/index.jsp?topic=/org.eclipse.pde.doc.user/guide/pde_configuring.htm "Concepts"] help topic in the PDE Guide.  The tutorial in the [[RCP Book]] also walks you through this process.
 
:For a recommended setup, follow these steps:
 
:# from the [http://download.eclipse.org/eclipse/downloads/ Platform downloads page], pick a build (e.g. the 3.1.2 release) and download the Eclipse SDK for your platform, the RCP SDK for your platform, and, optionally (if you want to deploy for other target platforms) the Delta Pack (the link is at the bottom of the RCP SDK section)
 
:# install the Eclipse SDK (aka the IDE) to some location (e.g. c:\eclipse)
 
:# install the RCP SDK (this has just the base RCP plug-ins) to some other location (e.g. c:\eclipse-RCP-SDK)
 
:# optionally install the Delta Pack also to the RCP SDK location
 
:# run the IDE (c:\eclipse\eclipse.exe)
 
:# go to Window > Preferences > Plugin-Development > Target Platform, and configure the location to be the eclipse subdirectory of the RCP SDK install (e.g. c:\eclipse-RCP-SDK\eclipse); note: if you type or paste the path, you'll need to press the Reload button
 
:# the list of plug-in on the Plugins tab should update to show RCP SDK plug-ins; other plug-ins like those for JDT and PDE should not appear
 
:Now, any plug-in projects in your workspace will be built against the RCP SDK plug-ins rather than the IDE's.
 
:PDE currently supports two versions back for plug-in development.  That is, with Eclipse 3.2 you can develop 3.0 plugins and launch 3.0 systems, but not 2.1 or earlier.
 
 
<div id="newLook"/>
 
<div id="r21pres"/>
 
<div id="presentations"/>
 
 
==Will an RCP application inherit the Eclipse IDE look?==
 
:By default, RCP apps use the same presentation as the IDE, but with different defaults (e.g. tabs are "traditional"). However, other presentation implementations are available.  For example, the R2.1 presentation available in the IDE can also be used by RCP apps; it is provided in the <code>org.eclipse.ui.presentations.r21</code> plug-in.
 
:For instructions on how to deploy the R2.1 presentation, see [[RCP Custom Look and Feel]].
 
:The default presentation of views and editors, and the overall window layout, is also configurable in several ways. See the following entries for more details. 
 
 
<div id="windowImage"/>
 
 
==How can I change the window icon in my application?==
 
:[http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/product_def.htm Define a product] via the [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/product_def_extpt.htm products extension point] and specify the <code>windowImages</code> property to refer to two image files, a 16x16 one and a 32x32 one. 
 
:It is best to specify both, since a 16x16 icon is typically used in the window trim, and a 32x32 icon is typically used in the OS's application switcher (e.g. Alt+Tab on Windows). If only one is specified, it is scaled up or down as needed, which can result in poor quality.
 
:For example, the [[RCP Browser Example|Browser Example]] has the following in its plugin.xml:
 
<pre>
 
<extension point="org.eclipse.core.runtime.products" id="product">
 
  <product
 
    name="%productName"
 
    application="org.eclipse.ui.examples.rcp.browser.app">
 
    <property
 
      name="windowImages"
 
      value="icons/eclipse.gif,icons/eclipse32.gif"/>
 
    ...
 
  </product>
 
</extension>
 
</pre>
 
 
 
:For more details, see the [http://eclipse.org/articles/Article-Branding/branding-your-application.html Branding Your Application] article.
 
 
<div id="customPrefs"/>
 
 
==How can I change the default UI settings for the perspective bar location, fast view bar location, etc?==
 
:Several UI settings such as the perspective bar location, fast view bar location, traditional vs. curvy tabs, etc., are controlled by preferences on the UI plug-in. These have default values defined by the generic workbench. However, the product can override these default values using the product preference customization mechanism.
 
:[http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/product_def.htm Define a product] via the [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/product_def_extpt.htm products extension point] and add the following property:
 
<pre>
 
<property
 
  name="preferenceCustomization"
 
  value="plugin_customization.ini"/>
 
</pre>
 
:Then create a file called <code>plugin_customization.ini</code>, in the same directory as the <code>plugin.xml</code> file, with contents of the form:
 
<pre>
 
<pluginId>/<preferenceName>=<preferenceValue>
 
</pre>
 
:For example, to show the perspective bar and fast view bar on the left, and to use curvy tabs, add the following to the <code>plugin_customization.ini</code> file:
 
<pre>
 
org.eclipse.ui/DOCK_PERSPECTIVE_BAR=left
 
org.eclipse.ui/SHOW_TEXT_ON_PERSPECTIVE_BAR=false
 
org.eclipse.ui/initialFastViewBarLocation=left
 
org.eclipse.ui/SHOW_TRADITIONAL_STYLE_TABS=false
 
</pre>
 
:For a list of public preferences available on the UI plug-in and their valid values, see the interface [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/IWorkbenchPreferenceConstants.html org.eclipse.ui.IWorkbenchPreferenceConstants].
 
:For more details, see the [http://eclipse.org/articles/Article-Branding/branding-your-application.html Branding Your Application] article and the [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/product_configproduct.htm Customizing a product] section in Help.
 
 
<div id="actionSetOrder"/>
 
==How can I get action set menus to appear in the right order, between my app's main menus?==
 
:When adding main menus to the menu manager in your WorkbenchAdvisor's fillActionBars method, add an "additions" group marker where you'd like action sets to appear.
 
<pre>
 
menuBar.add(fileMenu);
 
menuBar.add(new GroupMarker(IWorkbenchActionConstants.MB_ADDITIONS));
 
menuBar.add(helpMenu);
 
</pre>
 
 
 
<div id="multiViews"/>
 
==Can multiple instances of the same view be made to appear at the same time?==
 
:Yes.  See IWorkbenchPage.showView(String primaryId, String secondaryId, int mode).
 
:The <view> element in the plugin.xml must also specify allowMultiple="true".
 
:Be sure to use a different <code>secondaryId</code> for each instance, otherwise <code>showView</code> will find any existing view with the same primaryId and secondaryId rather than showing a new one.
 
:To pass instance-specific data to the view, you will need to cast the resulting IViewPart down to the concrete view class and call your own setData method.
 
:Note that views with a secondaryId will not match placeholders specifying just the primaryId. In a perspective factory, placeholders can be added for multi-instance views using the format <code>primaryId + ':' + secondaryId</code>, where '*' wildcards are supported.
 
 
<div id="deployment"/>
 
==How can I deploy my RCP app?==
 
:[[Rich Client Platform#tutorials|Part 1 of Ed Burnette's RCP tutorial]] discusses this in the section entitled '''Running it outside of Eclipse'''.  In Eclipse 3.1, there is also a product export wizard to simplify this process.
 
 
<div id="troubleshooting"/>
 
 
==When I try running, nothing happens, or it complains that the application could not be found in the registry, or that other plug-ins are missing. How can I track the problem down?==
 
:Try running first from within Eclipse using the Runtime Workbench (3.0 and 3.0.1) or Eclipse Application (3.1) launch configuration (Run > Debug...). Ensure that the application's plug-in(s) and all its prerequisites are selected in the Plug-ins tab. The easiest way is to select "Choose plug-ins and fragments to launch from the list", press Deselect All, check off the application's plug-in(s), and press Add Required Plug-ins. In 3.1, there is also a Validate Plug-in Set button to check that all prerequisites have been satisfied, without having to launch first. On the Main tab, be sure that the correct product or application is selected (using a product is preferred -- see the [http://eclipse.org/articles/Article-Branding/branding-your-application.html Branding Your Application] article).
 
 
:When running a deployed RCP application (not running from within Eclipse), ensure that the config.ini file in the configuration directory points to the correct product or application extension via the eclipse.product or eclipse.application entry (using a product is preferred -- see the [http://eclipse.org/articles/Article-Branding/branding-your-application.html Branding Your Application] article).  Either all plug-ins need to be specified in the osgi.bundles entry of the config.ini, or the '''org.eclipse.update.configurator''' plug-in should be included to discover all available plug-ins the first time the application is run.
 
 
:If eclipse fails silently, look in the configuration and/or workspace directories for a .log file. If you use the eclipse.exe launcher (or equivalent on other platforms) it will tell you where to find any relevant log file.
 
 
:Try adding -consolelog, -debug and -clean to the command line (as program arguments, not VM arguments). For example, to run the browser example with an explicitly specified product:
 
<pre>
 
d:\j2sdk1.4.2_01\bin\java org.eclipse.core.launcher.Main -product org.eclipse.ui.examples.rcp.browser.product -consolelog -clean -debug
 
</pre>
 
:or
 
<pre>
 
eclipse -vm d:\j2sdk1.4.2_01\bin\java -product org.eclipse.ui.examples.rcp.browser.product -consolelog -clean -debug
 
</pre>
 
:-consolelog causes any log entries to be sent to the console as well (to get a console window, be sure to use java as the VM instead of javaw).
 
:-debug causes Eclipse to log extra information about plug-in dependency problems (see [https://bugs.eclipse.org/bugs/show_bug.cgi?id=75648 here] for more background).
 
:-clean forces Eclipse to re-read all the plugin.xml files rather than using its cached representation of the plug-in registry.
 
 
 
:While these options are helpful for debugging, note that there is a performance penalty for -debug and -clean, so it is not recommended that they be used in the final product.
 
 
:For other troubleshooting hints, see the <b>Troubleshooting</b> section of the [http://eclipse.org/articles/Article-RCP-1/tutorial1.html RCP Tutorial, part 1].
 
 
<div id="orphanPlugins"/>
 
 
==My own RCP plug-ins are contributed by a feature. Why is the update manager complaining that my configuration is invalid?==
 
:If you're using a feature only for the plug-ins you write, the update manager does not check dependencies on "orphan" plug-ins (i.e. plug-ins not contributed by a feature) so the configuration appears invalid. You will need to either:
 
:* include all the plug-ins (yours and the RCP plug-ins) into your feature, or
 
:* create another feature for the RCP plug-ins.
 
 
<div id="nonResourceEditors"/>
 
==Are editors tied to the workspace resource model or to the broader notion of files?==
 
:No.  The concept of an editor in the workbench and the corresponding types (IEditorPart, EditorPart, IEditorInput) are not tied to the workspace resource model, or even to the notion of files (whether in the workspace or the file system).  Editors can be used for any kind of model, and can be textual or graphical.
 
 
:The Text component provides support for text editors.  See the entry for the Text component in the [[#otherComponents | list of optional components]] above.  See also the [[Rich Client Platform#Examples|RCP text editor example]].
 
 
:Eugene Ostroukhov has published [http://www.jroller.com/page/Zhou/20040215#eclipse_editors_not_tied_to a useful blog entry] describing how to create a non-file-based editor that connects to a database.  See also [http://www.jroller.com/page/Zhou/20040414#update_on_custom_editor_inputs this update].
 
 
<div id="swingIntegration"/>
 
==How can I integrate my existing Swing components into an RCP application?==
 
:Yes, see [http://www.eclipse.org/swt/faq.php#swinginswt this SWT FAQ entry].  Note, however, that the SWT_AWT bridge does not currently work on all platforms, e.g. Mac ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=67384 bug 67384]).
 
:See also the EclipseZone discussion [http://www.eclipsezone.com/eclipse/forums/t45697.html "Integrating Swing into Eclipse RCPs"]. 
 
:Also take a look at [http://swingwt.sourceforge.net/ SwingWT], an SWT-based implementation of the Swing API.
 
 
==How do I get my app to use Windows XP themes?==
 
:See [http://www.eclipse.org/swt/faq.php#xpthemes this SWT FAQ entry].  Note that the manifest file must have the name javaw.exe.manifest or java.exe.manifest, not eclipse.exe.manifest (since eclipse.exe only launches the splash screen and then invokes the Java VM).  The manifest file must be in the jre\bin folder for the VM you use to launch Eclipse.
 
 
<div id="keyBindings"/>
 
 
==How can I define key bindings for commands?==
 
:See the [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/wrkAdv_keyBindings.htm "Workbench key bindings" help topic] and [http://www.magma.ca/~pollockd/despumate/bindingsHowTo.html Douglas Pollock's article on key bindings].
 
 
==How can I get my views and editors to coordinate with each other?==
 
:See the article [http://www-128.ibm.com/developerworks/java/library/os-ecllink/index.html "Make your Eclipse applications richer with view linking"] by Chinmay Pandit.
 
:You can also track part activation and other lifecycle using [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/IPartService.html IPartService], [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/IPartListener.html IPartListener] and [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/IPartListener2.html IPartListener2].
 
:To track part lifecycle from within an existing view or editor, use the part service on the part's containing IWorkbenchPage:
 
<code>
 
  getSite().getPage().addPartListener(listener);
 
</code>
 
:From outside the page (e.g. from an action added to the window in the ActionBarAdvisor), use the part service on the IWorkbenchWindow:
 
<code>
 
  IWorkbenchWindow window = actionBarAdvisor.getActionBarConfigurer().getWindowConfigurer().getWindow();
 
  window.getPartService().addPartListener(listener);
 
</code>
 
:Be sure to remove the part listener in the appropriate dispose method.
 
 
<div id="helpPlugins"/>
 
 
==Which plug-ins are needed for the Eclipse Help system?==
 
:See [[#otherComponents|What other Eclipse components can be used in constructing RCP applications?]].  Be sure to include the '''org.eclipse.tomcat''' plug-in since the dependency on it is indirect.  The '''org.eclipse.help.ui''' plug-in requires the '''org.eclipse.help.appserver''' plug-in, which defines the '''org.eclipse.help.appserver.server''' extension point.  The '''org.eclipse.tomcat''' plug-in adds an extension to this extension point.  So although '''org.eclipse.tomcat''' is required, it's not found by adding all prerequisites of '''org.eclipse.help.ui''', and needs to be added manually.
 
:See also section 8 of the [http://www.eclipsecon.org/2005/presentations/EclipseCon2005_Tutorial8.pdf "Developing Eclipse Rich Client Applications" tutorial] from EclipseCon 2005.
 
:See also the [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/help.htm "Plugging in help"] help topic.
 
:See also the "Adding Help" chapter in the [[RCP Book]].
 
 
==How can I add the Eclipse Update Manager to my application?==
 
:See section 9 of the [http://www.eclipsecon.org/2005/presentations/EclipseCon2005_Tutorial8.pdf "Developing Eclipse Rich Client Applications" tutorial] from EclipseCon 2005.
 
:See also the [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/guide/product_update.htm "Updating a product or extension"] help topic.
 
:See also the "Adding Update" chapter of the [[RCP Book]].
 

Revision as of 11:17, 20 April 2006

3.2 Polish Items

Last update: March 15, 2006 (Changes since March 13, 2006 in green. New entries in Team and JDT UI)

New additions in green.

Entries in RED have been fixed.

Entries in BLUE are not in the plan for 3.2


So far, I have received input from the Search, Platform/JDT Text, JDT Core, JDT UI, and Debug teams. This document contains a summary of that feedback. The items are listed by component, but are otherwise in no particular order.

General / All

Bugzilla Description
Do we need a new splash screen? MVM asking designers to investigate in light of new welcome as well.
Update keywords for searching preference pages. I.e. verify that all the new preferences are covered.


Platform Runtime

Bugzilla Description
128178 [Workbench] earlyStartup does not work in runtime eclipse with binary-imported plugins

Platform Compare

Bugzilla Description
78063 Full Javadoc line selected even though only a character has been added to a word
68758 Structured Compare: selected added element not part of selection
128362 [Patch] Creating patch from compare in between versions/revisions
118021 Structured compare not available with additions or deletions

112661 (bugs logged by mvm previously)

132693

Cleanup UI of Create/Apply Patch wizards (follow Eclipse UI guidelines):
  • button sizes
  • caption
  • margins
  • mnemonics (missing)
  • polish all descriptions and messages
  • Match Project... button launches dialog called Retarget Patch (inconsistent)


    Platform CVS

    Bugzilla Description
    112927 [performance] Update CVS workspace job takes too long
    See also " [#too_may_password">too many passwords]" in the Platform UI section below.


    Platform Help

    Bugzilla Description
    New help support should be improved (2 votes):
    • Help button should be on the side where the help shows up. Should stay pushed, and a release should close the help view again
    • dialogs without help should better not get the help button
    • clicking on a link should directly open the help browser as the space next to the dialog is always too small


    Platform SWT

    Bugzilla Description
    95634 [Tree] TreeColumn does not show "..." on cut-off Text and misses tooltips
    I know I'm dreaming, but: styled ranges inside a tree item (Font/colors etc for e.g. a word inside the full label) would be a boost
    125702 If you collapse a tree on a recent version of GTK+, a big block of whitespace appears at the bottom. It's very irritating.

    123425

    5200

    There's also the "festival of carets" bug. This is immediately noticeable to anyone using a recent GTK+, and it makes us look bad. Unfortunately, it appears to be a bug somewhere in the Cairo/Pango/glib/GTK+ stack specific to the FPU mode (which the Java VM modifies on start-up). This bug is bad and will be hard to track down. We need to do work if we want to see this fixed; we can't just say "It's their problem".
     
     


    Platform Team

    Bugzilla Description
    Need a general polish pass on new History view filtering and user interactions. The bugs below are examples...
    125860 New history view: filter is not persisted - no way to constantly ignore local history
    129916 Per date sorting in History view forced on me upon ever input change
     

    MOVED FROM UI

    There are sometimes <a name="too_may_password">]too many password dialogs:

    • If I'm trying to work off-line but have CVS projects in workspace, it can happen that you get lots of dialogs to ask for the password as the CVS decorators each need that password. Clicking cancel once should be enough to let them know that I'm not interested in entering the password now.
    • It would be nice to have a less intrusive way of asking for passwords. Idea is e.g. a status line icon similar to the progress view that blinks when a passwords are pending. Clicking on this icon brings a 'authentication view' that shows that status of all passwords: passed, failed, canceled, and lets me trying to connect again.
    130408 Should be able to export psfs to the workspace (2 votes)


    Platform Text

    Bugzilla Description
    11624 Text Drag and Drop (has many bug votes)

    In order to resolve this we first need to put the grounds for drag and drop contributions to editors, otherwise clients contributing some sort of DnD will get broken. This is covered in bug 125957 and won't make it into 3.2.


    Platform UI

    Bugzilla Description
    119890

    [ViewMgmt] Allow control of view tab compression

    - this was changed in 3.2 and need to decide if we like it

    100993 [EditorMgmt][Presentations] Regression: Editor tabs do not remember order or active tab after restarting Eclipse

    Investigating

    128455 [Presentation] [ViewBar] Outline view toolbar is visible above a maximized editor
    131559 [Markers] Layout of marker filters dialog
    129936 [ViewMgmt] View part description label should wrap
    125691 [ViewMgmt] Can't read view titles
    68684 Remove MRU Ordering from the editors.</td>
       </tr>
    
    113455</td> Some errors do not appear in the Problems view. This happens very frequently for me (multi-processor box, GTK+) if I have grouping turned on.</td>
       </tr>
    
    130818</td> Filters do not seem to apply when grouping by Java type (Problems view).
           </td>
       </tr>
    
     </td>  </td>
       </tr>
    
    126155</td> [Markers] Issues of multi quick fix dialog</td>
       </tr>
    
    122639</td> [WorkbenchParts] PageBookView's toolbar doesn't properly re-layout after page switching</td>
       </tr>
    
    128670</td> [Dialogs] StatusDialog adds 2 horizontal margins around button bar</td>
       </tr>
    
    127629</td> [Markers] problems view: keep selection stable</td>
       </tr>
    
    128381, 128381</td> [Markers] group should only show (10 of 10 items) if beyond the limit</td>
       </tr>
    
    129812</td> [Markers] Enabling problem categorization per default</td>
       </tr>
    
    129184</td> Progress view should be made more prominent</td>
       </tr>
    
    127289</td> [Markers] SystemFilter and group selection
           state not preserved</td>
       </tr>
    
    see suggestions in bug 109998</td> Experimental (?) Keys preference page (3 votes):
    • what do we do with the two pages?
    • sorting by keys, by commands and by scope 109998
    • see which keys are free and which commands are not used
    • Platform UI team is investigating what can/can not be done about this without Doug around
    </td>
       </tr>
    
    </td> Finish the preferences clean up effort from 3.0:
    • decorator preference pages should offer a link to decorators</li>
    • font / color preferences should use shared settings so it is also possible to configure the color and font decoration for CVS on the CVS page
    • UI - please provide a bug for this so we can track polish
    </td>
       </tr>
    
    </td> Improve the look of the filter control (preferences, other dialogs):
    • the text field seems unaligned as long as there is no 'clear' button
    • either dump the 'clear' button, or add it as a lay-over over the text field:
      • For example, in Thunderbird (mozilla mail client), they added a magnifying glass inside the text field (Good visual indication what this field is about) and the clear button ('x', is IMO a better icon than what we have) is inside the text field when applicable. Even better is the help text in light gray.
      • UI - please provide a bug for this so we can track polish
    </td>
       </tr>
    
    </td>

    The fast view icon looks like a bug, as the lower right corner is missing. For all the icons on the fast view bar, it isn't obvious what they do. They should be more "inviting" to click on. Maybe some extra adornment in the icon like an arrow that points in the direction they will open. The tooltip should also show the keyboard shortcut.

    New icon is being requested, no other work decided at this point

    UI - please provide a bug for this so we can track polish

    </td>
       </tr>
    
    </td>  </td>
       </tr>
    

    </table>

    JDT Core

    Bugzilla Description
    108087 Java conventions default formatter settings confused
    118217

    Change 'unused parameters' warning to only work on private or final methods to avoid false positives.


    JDT Debug

    Bugzilla Description
    128074 Cannot format stack trace
    123589 Unexpected switch to empty editor when using scrapbook
    123588 Loosing key binding in scrapbook page
    130534 add a "collapse all" to the tree's toolbar
    128558 support variables in port and host fields of Remote Java Applications
    77125 preference for determing how Java breakpoints are created - to suspend thread or entire VM
    125768 Support to display breakpoints in rulers of external edtiors:
    • ideally, there would be support for markers in external files from text/platform, but we might be able to do something here (not sure how much work this is)
    • since we support breakpoints in external files, and the editor now supports a ruler in external files, we really should make the two work together
    80746 filter exceptions in anonymous classes of X when filtered on X
    89474 support to edit attributes of multiple archives at once
    110837 properly specify bootpath when launching to avoid problems with crypto applications
    Columns in Variables/Registers view:
    • We've added support to the debug platform for columns in debug views
    • We want to add support for columns in the java debugger as an optional presentation (we've started this already)
    • DEBUG - please provide a bug for this so we can track polish
    Undo/Redo:
    • We don't currently support undo/redo in the Scrapbook or Display view, which has made a few users angry
    • DEBUG - please provide a bug for this so we can track polish


    JDT Text

    Bugzilla Description
    95619 [5.0][content assist] Function parameter assist does not work with some parameterized types
    92371 [content assist] Parameter guessing could also propose expressions for parameters of array types
    41189 [hovering] Editor tooltip size too small for title text (3 votes)
    125677 [navigation] @category not standing out enough in Java Outline view
    91500 Improve the NLS tooling, especially existing hover and linking features to Eclipse string externalization support (2 votes)

    JDT UI

    Bugzilla Description
    129929 IDE no longer responsive when JUnit tests are running
    129925 [JUnit view] Hierarchical+failures should not show more than just failures
    130106 [junit] Hierarchical mode sometimes show testcase in progress and sometimes not
    130107 [junit view] Hierarchical mode not properly rebuilding the tree

    136572

    134078

    134305

    Polish the Clean Up support (2 votes):
    • Clean Up with focus on current file forces me to save other resources? This is particularly annoying when the resource is a text scratch file.
    • Clean Up should also offer to format the code.
    • The wizard needs polish.

    New Java Perspective (old one becomes the 'Classic Java Perspective')

    119259

    provide a way to get fully qualified class name into clipboard
    108256 [refactoring] [ltk] Refactoring preview does not correctly highlight 5.0 code [refactoring]
    122527 [build path] Offer a SWT container in JDT
    135279 [refactoring] improve order of refactoring actions
    135285 [source actions] improve order of source actions

    Back to the top