Bug 207877 - [Workbench] Interfaces should document their extension interfaces
Summary: [Workbench] Interfaces should document their extension interfaces
Status: NEW
Alias: None
Product: Platform
Classification: Eclipse Project
Component: UI (show other bugs)
Version: 3.4   Edit
Hardware: PC Windows XP
: P3 enhancement (vote)
Target Milestone: ---   Edit
Assignee: Platform UI Triaged CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-10-29 18:52 EDT by Markus Keller CLA
Modified: 2019-09-06 16:14 EDT (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Markus Keller CLA 2007-10-29 18:52:36 EDT
I20071029-0010

Platform/UI defines quite a few extension interfaces, but they are easy to miss when you just look at the original interface. Could you please add references to the extensions into the base interface?

Platform/Text has a good boilerplate for this, see e.g. ITextViewer:

[..]
 * In order to provide backward compatibility for clients of
 * <code>ITextViewer</code>, extension interfaces are used as a means of
 * evolution. The following extension interfaces exist:
 * <ul>
 * <li>{@link org.eclipse.jface.text.ITextViewerExtension} since version 2.0
 * replacing the event consumer mechanism and introducing the concept of rewrite
 * targets and means to manage the viewer's redraw behavior</li>
 * <li>{@link org.eclipse.jface.text.ITextViewerExtension2}since version 2.1
 * adding a way to invalidate a viewer's presentation and setters for hovers.
 * </li>
[..]

To find the extension interfaces, you can use "org.eclipse.ui.I*2" (and ...I*3, etc.) in the Open Type dialog, and then select them all at once to open in batch.
Comment 1 Eclipse Webmaster CLA 2019-09-06 16:14:59 EDT
This bug hasn't had any activity in quite some time. Maybe the problem got resolved, was a duplicate of something else, or became less pressing for some reason - or maybe it's still relevant but just hasn't been looked at yet.

If you have further information on the current state of the bug, please add it. The information can be, for example, that the problem still occurs, that you still want the feature, that more information is needed, or that the bug is (for whatever reason) no longer relevant.