1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-08-19 14:15:50 +02:00

[185552][api] Remove remoteSystemsViewPreferencesActions extension point

This commit is contained in:
Martin Oberhuber 2007-05-14 11:13:56 +00:00
parent 634409f74e
commit 5fa355b830
11 changed files with 42 additions and 326 deletions

View file

@ -74,10 +74,6 @@ Here are the extension points that are defined by the RSE:
users select the Properties action from the pop-up menu of remote users select the Properties action from the pop-up menu of remote
objects listed in the Remote Systems view.</TD> objects listed in the Remote Systems view.</TD>
</TR> </TR>
<TR>
<TD><A href="../reference/extension-points/org_eclipse_rse_ui_remoteSystemsViewPreferencesActions.html">org.eclipse.rse.ui.<b>remoteSystemsViewPreferencesActions</b></A></TD>
<TD>For contributing a fastpath action to jump to your preferences page, from the local pulldown menu of the Remote Systems view.</TD>
</TR>
<!-- TODODeferred after RSE 1.0 <!-- TODODeferred after RSE 1.0
<TR> <TR>
<TD><A href="../reference/extension-points/org_eclipse_rse_ui_compile.html">org.eclipse.rse.ui.<b>compile</b></A></TD> <TD><A href="../reference/extension-points/org_eclipse_rse_ui_compile.html">org.eclipse.rse.ui.<b>compile</b></A></TD>

View file

@ -22,7 +22,6 @@
--> -->
<li><a href="org_eclipse_rse_ui_mountPathMappers.html">org.eclipse.rse.ui.mountPathMappers</a></li> <li><a href="org_eclipse_rse_ui_mountPathMappers.html">org.eclipse.rse.ui.mountPathMappers</a></li>
<li><a href="org_eclipse_rse_ui_newConnectionWizards.html">org.eclipse.rse.ui.newConnectionWizards</a></li> <li><a href="org_eclipse_rse_ui_newConnectionWizards.html">org.eclipse.rse.ui.newConnectionWizards</a></li>
<li><a href="org_eclipse_rse_ui_remoteSystemsViewPreferencesActions.html">org.eclipse.rse.ui.remoteSystemsViewPreferencesActions</a></li>
</ul> </ul>
</body> </body>

View file

@ -17,7 +17,6 @@
--> -->
<topic label="org.eclipse.rse.ui.mountPathMappers" href="reference/extension-points/org_eclipse_rse_ui_mountPathMappers.html" /> <topic label="org.eclipse.rse.ui.mountPathMappers" href="reference/extension-points/org_eclipse_rse_ui_mountPathMappers.html" />
<topic label="org.eclipse.rse.ui.newConnectionWizards" href="reference/extension-points/org_eclipse_rse_ui_newConnectionWizards.html" /> <topic label="org.eclipse.rse.ui.newConnectionWizards" href="reference/extension-points/org_eclipse_rse_ui_newConnectionWizards.html" />
<topic label="org.eclipse.rse.ui.remoteSystemsViewPreferencesActions" href="reference/extension-points/org_eclipse_rse_ui_remoteSystemsViewPreferencesActions.html" />
<anchor id="rse-extension-points-ref" /> <anchor id="rse-extension-points-ref" />
</topic> </topic>

View file

@ -12,6 +12,7 @@
* *
* Contributors: * Contributors:
* Martin Oberhuber (Wind River) - [181066] NLS missing messages with DAEMON and Shells * Martin Oberhuber (Wind River) - [181066] NLS missing messages with DAEMON and Shells
* Martin Oberhuber (Wind River) - [185552] Remove remoteSystemsViewPreferencesActions extension point
********************************************************************************/ ********************************************************************************/
package org.eclipse.rse.internal.ui; package org.eclipse.rse.internal.ui;
@ -913,6 +914,9 @@ public class SystemResources extends NLS
public static String ACTION_PREFERENCE_SHOW_FILTERPOOLS_LABEL; public static String ACTION_PREFERENCE_SHOW_FILTERPOOLS_LABEL;
public static String ACTION_PREFERENCE_SHOW_FILTERPOOLS_TOOLTIP; public static String ACTION_PREFERENCE_SHOW_FILTERPOOLS_TOOLTIP;
public static String ACTION_SHOW_PREFERENCEPAGE_LABEL;
public static String ACTION_SHOW_PREFERENCEPAGE_TOOLTIP;
public static String ACTION_NEWCONN_LABEL; public static String ACTION_NEWCONN_LABEL;
public static String ACTION_NEWCONN_TOOLTIP; public static String ACTION_NEWCONN_TOOLTIP;

View file

@ -1,5 +1,5 @@
################################################################################ ################################################################################
# Copyright (c) 2000, 2007 IBM Corporation. All rights reserved. # Copyright (c) 2000, 2007 IBM Corporation and others. All rights reserved.
# This program and the accompanying materials are made available under the terms # This program and the accompanying materials are made available under the terms
# of the Eclipse Public License v1.0 which accompanies this distribution, and is # of the Eclipse Public License v1.0 which accompanies this distribution, and is
# available at http://www.eclipse.org/legal/epl-v10.html # available at http://www.eclipse.org/legal/epl-v10.html
@ -11,7 +11,7 @@
# Emily Bruner, Mazen Faraj, Adrian Storisteanu, Li Ding, and Kent Hawley. # Emily Bruner, Mazen Faraj, Adrian Storisteanu, Li Ding, and Kent Hawley.
# #
# Contributors: # Contributors:
# {Name} (company) - description of contribution. # Martin Oberhuber (Wind River) - [185552] Remove remoteSystemsViewPreferencesActions extension point
################################################################################ ################################################################################
# NLS_MESSAGEFORMAT_VAR # NLS_MESSAGEFORMAT_VAR
@ -812,6 +812,9 @@ ACTION_RESTORE_STATE_PREFERENCE_TOOLTIP=If selected, the tree is re-expanded to
ACTION_PREFERENCE_SHOW_FILTERPOOLS_LABEL=Show Filter Pools ACTION_PREFERENCE_SHOW_FILTERPOOLS_LABEL=Show Filter Pools
ACTION_PREFERENCE_SHOW_FILTERPOOLS_TOOLTIP=Show filter pools when expanding subsystems ACTION_PREFERENCE_SHOW_FILTERPOOLS_TOOLTIP=Show filter pools when expanding subsystems
ACTION_SHOW_PREFERENCEPAGE_LABEL=Remote Systems...
ACTION_SHOW_PREFERENCEPAGE_TOOLTIP=Go to the Remote Systems primary preferences page
ACTION_NEWCONN_LABEL=New Connection... ACTION_NEWCONN_LABEL=New Connection...
ACTION_NEWCONN_TOOLTIP=Define a connection to remote system ACTION_NEWCONN_TOOLTIP=Define a connection to remote system

View file

@ -1,5 +1,5 @@
/******************************************************************************** /********************************************************************************
* Copyright (c) 2002, 2006 IBM Corporation. All rights reserved. * Copyright (c) 2002, 2007 IBM Corporation and others. All rights reserved.
* This program and the accompanying materials are made available under the terms * This program and the accompanying materials are made available under the terms
* of the Eclipse Public License v1.0 which accompanies this distribution, and is * of the Eclipse Public License v1.0 which accompanies this distribution, and is
* available at http://www.eclipse.org/legal/epl-v10.html * available at http://www.eclipse.org/legal/epl-v10.html
@ -11,7 +11,7 @@
* Emily Bruner, Mazen Faraj, Adrian Storisteanu, Li Ding, and Kent Hawley. * Emily Bruner, Mazen Faraj, Adrian Storisteanu, Li Ding, and Kent Hawley.
* *
* Contributors: * Contributors:
* {Name} (company) - description of contribution. * Martin Oberhuber (Wind River) - [185552] Remove remoteSystemsViewPreferencesActions extension point
********************************************************************************/ ********************************************************************************/
package org.eclipse.rse.internal.ui.actions; package org.eclipse.rse.internal.ui.actions;
@ -36,9 +36,8 @@ import org.eclipse.ui.internal.dialogs.WorkbenchPreferenceDialog;
* preference page (it will include its children underneath), including the * preference page (it will include its children underneath), including the
* child pages registered under that page ("category"). * child pages registered under that page ("category").
* <p> * <p>
* This is used by the org.eclipse.rse.core.remoteSystemsViewPreferencesActions * @deprecated this will be moved to use the command/handler extension point.
* extension point. * @see SystemCascadingPreferencesAction
* @see org.eclipse.rse.ui.actions.SystemCascadingPreferencesAction
*/ */
public class SystemShowPreferencesPageAction extends SystemBaseAction implements IViewActionDelegate public class SystemShowPreferencesPageAction extends SystemBaseAction implements IViewActionDelegate
{ {
@ -48,8 +47,9 @@ public class SystemShowPreferencesPageAction extends SystemBaseAction implements
private String preferencePageCategory; private String preferencePageCategory;
/** /**
* Constructor. We are instantiated inside {@link RSEUIPlugin#getShowPreferencePageActions()} * Constructor.
* for each extension of our extension point <code>org.eclipse.rse.core.remoteSystemsViewPreferencesActions</code> * We are instantiated inside {@link RSEUIPlugin#getShowPreferencePageActions()}
* for each menu shortcut to show a particular preference page.
*/ */
public SystemShowPreferencesPageAction() public SystemShowPreferencesPageAction()
{ {

View file

@ -16,6 +16,7 @@
* Martin Oberhuber (Wind River) - Replace SystemRegistry by ISystemRegistry * Martin Oberhuber (Wind River) - Replace SystemRegistry by ISystemRegistry
* Martin Oberhuber (Wind River) - [168975] Move RSE Events API to Core * Martin Oberhuber (Wind River) - [168975] Move RSE Events API to Core
* Martin Oberhuber (Wind River) - [177523] Unify singleton getter methods * Martin Oberhuber (Wind River) - [177523] Unify singleton getter methods
* Martin Oberhuber (Wind River) - [185552] Remove remoteSystemsViewPreferencesActions extension point
********************************************************************************/ ********************************************************************************/
package org.eclipse.rse.internal.ui.view; package org.eclipse.rse.internal.ui.view;
@ -726,8 +727,8 @@ public class SystemViewPart
menuMgr.add(showFilterPoolsAction); menuMgr.add(showFilterPoolsAction);
menuMgr.add(restoreStateAction); // d51541 menuMgr.add(restoreStateAction); // d51541
// Now query our remoteSystemsViewPreferencesActions for extenders who wish to appear in the // Now display any contributed action shortcuts for bringing up
// preferences cascading menu... // a particular preference page...
SystemCascadingPreferencesAction preferencesAction = new SystemCascadingPreferencesAction(shell); SystemCascadingPreferencesAction preferencesAction = new SystemCascadingPreferencesAction(shell);
menuMgr.add(preferencesAction.getSubMenu()); menuMgr.add(preferencesAction.getSubMenu());

View file

@ -20,6 +20,7 @@
* Martin Oberhuber (Wind River) - [174945] Remove obsolete icons from rse.shells.ui * Martin Oberhuber (Wind River) - [174945] Remove obsolete icons from rse.shells.ui
* Martin Oberhuber (Wind River) - [186525] Move keystoreProviders to core * Martin Oberhuber (Wind River) - [186525] Move keystoreProviders to core
* Martin Oberhuber (Wind River) - [186523] Move subsystemConfigurations from UI to core * Martin Oberhuber (Wind River) - [186523] Move subsystemConfigurations from UI to core
* Martin Oberhuber (Wind River) - [185552] Remove remoteSystemsViewPreferencesActions extension point
********************************************************************************/ ********************************************************************************/
package org.eclipse.rse.ui; package org.eclipse.rse.ui;
@ -694,86 +695,28 @@ public class RSEUIPlugin extends SystemBasePlugin implements ISystemMessageProvi
return getDefault().isSystemRegistryActive(); return getDefault().isSystemRegistryActive();
} }
/** /**
* Return all elements that extend the org.eclipse.rse.ui.remoteSystemsViewPreferencesActions extension point * Return an array of action objects to show for the "Preferences..."
*/ * submenu of the RSE System View.
private IConfigurationElement[] getPreferencePageActionPlugins() * For contributing a fastpath action to jump to your preferences page,
{ * from the local pulldown menu of the Remote Systems view.
// Get reference to the plug-in registry * This may return null if no such actions are registered.
IExtensionRegistry registry = Platform.getExtensionRegistry(); * @deprecated will be moved to using command/hander extension point
// Get configured extenders
IConfigurationElement[] prefPageExtensions =
registry.getConfigurationElementsFor(PLUGIN_ID,"remoteSystemsViewPreferencesActions"); //$NON-NLS-1$
return prefPageExtensions;
}
/**
* Return an array of action objects registered via our org.eclipse.rse.ui.remoteSystemsViewPreferencesActions
* extension point. <br>
* This may return null if there are no extenders.
*/ */
public SystemShowPreferencesPageAction[] getShowPreferencePageActions() public SystemShowPreferencesPageAction[] getShowPreferencePageActions()
{ {
if (showPrefPageActions == null) if (showPrefPageActions == null)
{ {
IConfigurationElement[] showPrefPagePlugins = getPreferencePageActionPlugins(); //add our own preferences page action hardcoded
if (showPrefPagePlugins != null) SystemShowPreferencesPageAction action = new SystemShowPreferencesPageAction();
{ action.setPreferencePageID("org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage"); //$NON-NLS-1$
Vector v = new Vector(); //action.setPreferencePageCategory(preferencePageCategory)
for (int idx=0; idx<showPrefPagePlugins.length; idx++) //action.setImageDescriptor(id);
{ action.setText(SystemResources.ACTION_SHOW_PREFERENCEPAGE_LABEL);
SystemShowPreferencesPageAction action = new SystemShowPreferencesPageAction(); action.setToolTipText(SystemResources.ACTION_SHOW_PREFERENCEPAGE_TOOLTIP);
action.setHelp("org.eclipse.rse.ui.aprefrse"); //$NON-NLS-1$
String prefPageId = showPrefPagePlugins[idx].getAttribute("preferencePageId"); //$NON-NLS-1$ showPrefPageActions = new SystemShowPreferencesPageAction[1];
if ((prefPageId!=null)&&(prefPageId.length()>0)) showPrefPageActions[0] = action;
{
action.setPreferencePageID(prefPageId);
}
String prefPageCategory = showPrefPagePlugins[idx].getAttribute("preferencePageCategory"); //$NON-NLS-1$
if ((prefPageCategory!=null)&&(prefPageCategory.length()>0))
{
action.setPreferencePageCategory(prefPageCategory);
}
String iconFile = showPrefPagePlugins[idx].getAttribute("icon"); //$NON-NLS-1$
if ((iconFile!=null)&&(iconFile.length()>0))
{
// get namespace of extension (i.e. the id of the declaring plugin)
String nameSpace = showPrefPagePlugins[idx].getDeclaringExtension().getNamespaceIdentifier();
// now get the associated bundle
Bundle bundle = Platform.getBundle(nameSpace);
ImageDescriptor id = getPluginImage(bundle, iconFile);
if (id != null) {
action.setImageDescriptor(id);
}
}
String label = showPrefPagePlugins[idx].getAttribute("label"); //$NON-NLS-1$
if ((label!=null)&&(label.length()>0))
{
action.setText(label);
}
String tooltip = showPrefPagePlugins[idx].getAttribute("tooltip"); //$NON-NLS-1$
if ((tooltip!=null)&&(tooltip.length()>0))
{
action.setToolTipText(tooltip);
}
String heldId = showPrefPagePlugins[idx].getAttribute("helpContextId"); //$NON-NLS-1$
if ((heldId!=null)&&(heldId.length()>0))
{
action.setHelp(heldId);
}
v.addElement(action);
} // end for all plugins loop
showPrefPageActions = new SystemShowPreferencesPageAction[v.size()];
for (int idx=0; idx<v.size(); idx++)
showPrefPageActions[idx] = (SystemShowPreferencesPageAction)v.elementAt(idx);
}
} }
return showPrefPageActions; return showPrefPageActions;
} }

View file

@ -15,6 +15,7 @@
# method for translatable label. # method for translatable label.
# Martin Oberhuber (Wind River) - [186525] Move keystoreProviders to core # Martin Oberhuber (Wind River) - [186525] Move keystoreProviders to core
# Martin Oberhuber (Wind River) - [186523] Move subsystemConfigurations from UI to core # Martin Oberhuber (Wind River) - [186523] Move subsystemConfigurations from UI to core
# Martin Oberhuber (Wind River) - [185552] Remove remoteSystemsViewPreferencesActions extension point
################################################################################ ################################################################################
# NLS_MESSAGEFORMAT_NONE # NLS_MESSAGEFORMAT_NONE
@ -24,7 +25,6 @@ pluginName = RSE UI
providerName = Eclipse.org providerName = Eclipse.org
extPoint.newConnectionWizard = New Connection Wizard extPoint.newConnectionWizard = New Connection Wizard
extPoint.remoteSystemsViewPreferencesActions = Remote Systems View Preferences Actions
#extPoint.compile = Remote Compile Commands #extPoint.compile = Remote Compile Commands
extPoint.mountPathMappers = Mount Path Mappers extPoint.mountPathMappers = Mount Path Mappers
@ -68,9 +68,6 @@ View.Scratchpad = Remote Scratchpad
View.Monitor = Remote Monitor View.Monitor = Remote Monitor
PreferencePageAction.rse.label = Remote Systems...
PreferencePageAction.rse.tooltip = Go to the Remote Systems primary preferences page
# Decorators # Decorators
SubSystemErrorDecorator.label=SubSystem Error Decorator SubSystemErrorDecorator.label=SubSystem Error Decorator

View file

@ -15,47 +15,10 @@ Contributors:
Martin Oberhuber (Wind River) - [185554] Remove dynamicPopupMenuExtensions extension point Martin Oberhuber (Wind River) - [185554] Remove dynamicPopupMenuExtensions extension point
Martin Oberhuber (Wind River) - [186525] Move keystoreProviders to core Martin Oberhuber (Wind River) - [186525] Move keystoreProviders to core
Martin Oberhuber (Wind River) - [186523] Move subsystemConfigurations from UI to core Martin Oberhuber (Wind River) - [186523] Move subsystemConfigurations from UI to core
Martin Oberhuber (Wind River) - [185552] Remove remoteSystemsViewPreferencesActions extension point
--> -->
<?eclipse version="3.1"?> <?eclipse version="3.1"?>
<plugin> <plugin>
<!-- ================================================================================== -->
<!-- EXTENSION POINT: org.eclipse.rse.ui.remoteSystemsViewPreferencesActions -->
<!-- ================================================================================== -->
<!-- Extension point for defining actions that appear in the cascading Preferences menu -->
<!-- in the local pulldown menu for the Remote Systems view. These actions should -->
<!-- take the directly to a preference page root, as a shortcut to navigating the -->
<!-- Windows->Preferences preferences dialog. The action's class should extend the -->
<!-- class org.eclipse.rse.ui.actions.SystemBasePreferencesPageAction. -->
<!-- -->
<!-- Example of extension configuration: -->
<!-- <extension point="org.eclipse.rse.ui.remoteSystemsViewPreferencesActions"> -->
<!-- <action -->
<!-- id="com.acme.showMyPreferencePage" -->
<!-- label="My Preferences" -->
<!-- preferencePageId="com.acme.myPreferencePage"> -->
<!-- </action> -->
<!-- </extension> -->
<!-- -->
<!-- <action> tag attributes: -->
<!-- ================================================================================== -->
<!-- id => unique id for this action. -->
<!-- label => label for the action. This will be displayed in the -->
<!-- preferences cascading menu. -->
<!-- preferencePageId => the "id" value of your org.eclipse.ui.preferencePages -->
<!-- extension, for the preference page to root the -->
<!-- preferences dialog to when the action is selected -->
<!-- preferencePageCategory => if this is not a root page, then specify the id of the -->
<!-- root page this is part of. This should be the absolute -->
<!-- root, not the immediate parent. It tells us what root tree -->
<!-- to search in to find the child. -->
<!-- icon => optional. Icon to display for this action. -->
<!-- tooltip => optional. Tooltip text to show in hover help. -->
<!-- helpContextId => optional. ID of contextual help to show when F1 is pressed -->
<!-- -->
<!-- See the extension point reference for more details. -->
<extension-point id="remoteSystemsViewPreferencesActions" name="%extPoint.remoteSystemsViewPreferencesActions" schema="schema/remoteSystemsViewPreferencesActions.exsd"/>
<!-- ============================================ --> <!-- ============================================ -->
<!-- Define a RemoteSystems project nature --> <!-- Define a RemoteSystems project nature -->
<!-- ============================================ --> <!-- ============================================ -->
@ -301,15 +264,19 @@ Martin Oberhuber (Wind River) - [186523] Move subsystemConfigurations from UI to
<!-- ================================================================================= --> <!-- ================================================================================= -->
<!-- Define Remote System Explorer view pulldown menu submenu for preferences actions --> <!-- Define Remote System Explorer view pulldown menu submenu for preferences actions -->
<!-- ================================================================================= --> <!-- ================================================================================= -->
<!-- TODO migrate to command/handler
<extension point="org.eclipse.rse.ui.remoteSystemsViewPreferencesActions"> <extension point="org.eclipse.rse.ui.remoteSystemsViewPreferencesActions">
<action <action
id="org.eclipse.rse.ui.preferences.actions.rse" id="org.eclipse.rse.ui.preferences.actions.rse"
label="%PreferencePageAction.rse.label" label="%PreferencePageAction.rse.label"
preferencePageId="org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage" preferencePageId="org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage"
preferencePageCategory=""
icon=""
tooltip="%PreferencePageAction.rse.tooltip" tooltip="%PreferencePageAction.rse.tooltip"
helpContextId="org.eclipse.rse.ui.aprefrse" helpContextId="org.eclipse.rse.ui.aprefrse"
/> />
</extension> </extension>
-->
<!-- ============================================ --> <!-- ============================================ -->
<!-- Define Remote Systems Perspective --> <!-- Define Remote Systems Perspective -->

View file

@ -1,193 +0,0 @@
<?xml version='1.0' encoding='UTF-8'?>
<!-- Schema file written by PDE -->
<schema targetNamespace="org.eclipse.rse.ui">
<annotation>
<appInfo>
<meta.schema plugin="org.eclipse.rse.ui" id="remoteSystemsViewPreferencesActions" name="Remote Systems View Preferences Page Action"/>
</appInfo>
<documentation>
This extension point is for contributing an action to the Remote Systems view pulldown menu, to the Preferences cascading menu. This action will launch the Preferences dialog, scoped to the particular page you specify. This will automatically show any child pages as well. This point is easy to extend, no coding required. Just name the preference page by its id from the preferencePages extension that defined the page. Also, if it is not a root page, then you must also name the root page (such as when using Windows-&amp;gt;Preference) by its id from its preferencePages extension.
This would be used by anyone who extends the Remote System Explorer, and offers preference pages for their users, and wants a shortcut to those preference pages for convenience.
</documentation>
</annotation>
<element name="extension">
<annotation>
<documentation>
(no description available)
</documentation>
</annotation>
<complexType>
<sequence>
<element ref="action" minOccurs="1" maxOccurs="unbounded"/>
</sequence>
<attribute name="point" type="string" use="required">
<annotation>
<documentation>
</documentation>
</annotation>
</attribute>
<attribute name="id" type="string">
<annotation>
<documentation>
</documentation>
</annotation>
</attribute>
<attribute name="name" type="string">
<annotation>
<documentation>
</documentation>
</annotation>
</attribute>
</complexType>
</element>
<element name="action">
<annotation>
<appInfo>
<meta.element labelAttribute="label" icon="icon"/>
</appInfo>
<documentation>
(no description available)
</documentation>
</annotation>
<complexType>
<attribute name="id" type="string" use="required">
<annotation>
<documentation>
A unique identifier for this extension.
</documentation>
</annotation>
</attribute>
<attribute name="label" type="string" use="required">
<annotation>
<documentation>
The display name for the action, shown in the menu. Include any mnenomnic if desired.
</documentation>
</annotation>
</attribute>
<attribute name="preferencePageId" type="string" use="required">
<annotation>
<documentation>
This matches the &quot;id&quot; attribute on the preferencePages extension, for the preference page you wish to show in the Preference Dialog for this action. If the preference page is a root (no &quot;category&quot; attribute in its preferencePages extension), this is all you need. Else, you also need to specify the preferencePageCategory attribute.
Note this page will be shown as the root in the Preferences dialog, but it can be expanded to see its child nodes.
</documentation>
</annotation>
</attribute>
<attribute name="preferencePageCategory" type="string">
<annotation>
<documentation>
This is required if the preference page you wish to show is not a root page, which means if it has a &quot;category&quot; attribute in its preferencePage extension definition. If so, here you give the &quot;id&quot; value of the preference page&apos;s root page... not its immediate parent! Be careful. We need to know the id of the root page so we know which root to recursively search the children of to find the page you specified in the preferencePageId attribute.
</documentation>
</annotation>
</attribute>
<attribute name="icon" type="string">
<annotation>
<documentation>
A relative path to an icon that will be displayed in the menu, with the label. Optional
</documentation>
<appInfo>
<meta.attribute kind="resource"/>
</appInfo>
</annotation>
</attribute>
<attribute name="tooltip" type="string">
<annotation>
<documentation>
A description of the action, for display on the status line, although it doesn&apos;t seem to work just yet. Optional
</documentation>
</annotation>
</attribute>
<attribute name="helpContextId" type="string">
<annotation>
<documentation>
The id of help to be shown when F1 is pressed while this action is selected. Optional
</documentation>
</annotation>
</attribute>
</complexType>
</element>
<annotation>
<appInfo>
<meta.section type="examples"/>
</appInfo>
<documentation>
&lt;extension point=&quot;org.eclipse.rse.ui.remoteSystemsViewPreferencesActions&quot;&gt;
&lt;action
id=&quot;org.eclipse.rse.ui.preferences.actions.rse&quot;
label=&quot;%PreferencePageAction.rse.label&quot;
preferencePageId=&quot;org.eclipse.rse.ui.ui.preferences.RemoteSystemsPreferencePage&quot;
tooltip=&quot;%PreferencePageAction.rse.tooltip&quot;
helpContextId=&quot;org.eclipse.rse.ui.aprefrse&quot;
/&gt;
&lt;/extension&gt;
&lt;extension point=&quot;org.eclipse.rse.ui.remoteSystemsViewPreferencesActions&quot;&gt;
&lt;action
id=&quot;com.acme.tools.core.preferences.rse&quot;
label=&quot;%PreferencePageAction.rse.label&quot;
preferencePageId=&quot;com.acme.tools.core.ui.preferences.PreferencePage&quot;
preferencePageCategory=&quot;org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage&quot;
tooltip=&quot;%PreferencePageAction.rse.tooltip&quot;
helpContextId=&quot;com.acme.tools.core.aprefrse&quot;
/&gt;
&lt;action
id=&quot;com.acme.tools.core.preferences.editor&quot;
label=&quot;%PreferencePageAction.editor.label&quot;
preferencePageId=&quot;com.acme.tools.editor.preferences.EditorGeneralPreferencePage&quot;
preferencePageCategory=&quot;org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage&quot;
tooltip=&quot;%PreferencePageAction.editor.tooltip&quot;
helpContextId=&quot;com.acme.tools.core.helpcontext01&quot;
/&gt;
&lt;action
id=&quot;com.acme.tools.core.preferences.cache&quot;
label=&quot;%PreferencePageAction.cache.label&quot;
preferencePageId=&quot;com.acme.tools.core.ui.preferences.CachingPreferencePage&quot;
preferencePageCategory=&quot;org.eclipse.rse.ui.preferences.RemoteSystemsPreferencePage&quot;
tooltip=&quot;%PreferencePageAction.caching.tooltip&quot;
helpContextId=&quot;com.acme.tools.core.helpcontext02&quot;
/&gt;
&lt;/extension&gt;
</documentation>
</annotation>
<annotation>
<appInfo>
<meta.section type="apiInfo"/>
</appInfo>
<documentation>
Since no coding is required, there is no API information.
</documentation>
</annotation>
<annotation>
<appInfo>
<meta.section type="implementation"/>
</appInfo>
<documentation>
This extension point is used by the &lt;code&gt;org.eclipse.rse.ui.actions.SystemCascadingPreferencesAction&lt;/code&gt; class, which in turn creates a &lt;code&gt;org.eclipse.rse.ui.actions.SystemShowPreferencesPageAction&lt;/code&gt; object for each extension of this point. These are used to populate the Preferences cascading menu of the Remote Systems view pulldown, but could be used elsewhere too, if desired.
</documentation>
</annotation>
<annotation>
<appInfo>
<meta.section type="copyright"/>
</appInfo>
<documentation>
Copyright (c) 2002, 2006 IBM Corporation. All Rights Reserved.
This program and the accompanying materials are made available under the terms
of the Eclipse Public License v1.0 which accompanies this distribution, and is
available at http://www.eclipse.org/legal/epl-v10.html
Contributors:
IBM Corporation - initial API and implementation
</documentation>
</annotation>
</schema>