null to allow all registered valid system types.
* A system type is valid if at least one subsystem configuration
diff --git a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/view/ISystemTableViewColumnManager.java b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/view/ISystemTableViewColumnManager.java
index 288f7d799c9..acf9b0db9ce 100644
--- a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/view/ISystemTableViewColumnManager.java
+++ b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/view/ISystemTableViewColumnManager.java
@@ -1,13 +1,13 @@
/********************************************************************************
* Copyright (c) 2008 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
+ * of the Eclipse Public License v1.0 which accompanies this distribution, and is
* available at http://www.eclipse.org/legal/epl-v10.html
- *
+ *
* Initial Contributors:
* The following IBM employees contributed to the Remote System Explorer
* component that contains this file: David McKnight.
- *
+ *
* Contributors:
* David McKnight (IBM) - [225506] [api][breaking] RSE UI leaks non-API types
********************************************************************************/
@@ -15,9 +15,12 @@ package org.eclipse.rse.ui.view;
import org.eclipse.ui.views.properties.IPropertyDescriptor;
+/**
+ * @since 3.0
+ */
public interface ISystemTableViewColumnManager {
public IPropertyDescriptor[] getVisibleDescriptors(ISystemViewElementAdapter adapter);
-
+
public void setCustomDescriptors(ISystemViewElementAdapter adapter, IPropertyDescriptor[] descriptors);
}
diff --git a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/view/SystemAbstractAPIProvider.java b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/view/SystemAbstractAPIProvider.java
index e95744dd5fb..ea7560fceef 100644
--- a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/view/SystemAbstractAPIProvider.java
+++ b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/view/SystemAbstractAPIProvider.java
@@ -34,8 +34,13 @@ import org.eclipse.rse.ui.RSEUIPlugin;
/**
- * This is a base class that a provider of root nodes to the remote systems tree viewer part can
- * use as a parent class.
+ * This is a base class that a provider of root nodes to the remote systems tree
+ * viewer part can use as a parent class.
+ *
+ * This class existed in RSE 1.0, was made "internal" for RSE 2.0 and restored
+ * as API for RSE 3.0.
+ *
+ * @since 3.0
*/
public abstract class SystemAbstractAPIProvider
implements ISystemViewInputProvider
diff --git a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/widgets/services/FactoryServiceElement.java b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/widgets/services/FactoryServiceElement.java
index eb8e8868cdf..00c520dfabc 100644
--- a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/widgets/services/FactoryServiceElement.java
+++ b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/widgets/services/FactoryServiceElement.java
@@ -7,10 +7,10 @@
*
* Initial Contributors:
* The following IBM employees contributed to the Remote System Explorer
- * component that contains this file: David McKnight, Kushal Munir,
- * Michael Berger, David Dykstal, Phil Coulthard, Don Yantzi, Eric Simpson,
+ * component that contains this file: David McKnight, Kushal Munir,
+ * Michael Berger, David Dykstal, Phil Coulthard, Don Yantzi, Eric Simpson,
* Emily Bruner, Mazen Faraj, Adrian Storisteanu, Li Ding, and Kent Hawley.
- *
+ *
* Contributors:
* David Dykstal (IBM) - [217556] remove service subsystem types
*******************************************************************************/
@@ -31,54 +31,66 @@ import org.eclipse.rse.services.IService;
public class FactoryServiceElement extends ServiceElement
{
- private ISubSystemConfiguration _factory;
+ private ISubSystemConfiguration _factory;
private ServiceElement[] _children;
+ /**
+ * Constructor. Used to accept an IServiceSubSystemConfiguration before RSE
+ * 3.0
+ *
+ * @since 3.0
+ */
public FactoryServiceElement(IHost host, ISubSystemConfiguration factory)
{
super(host, null);
_factory = factory;
}
-
+
public String getName()
{
return _factory.getId();
}
-
+
public String getDescription()
{
return _factory.getDescription();
}
-
+
+ /**
+ * Return the subsystem configuration related to this service element. Used
+ * to return an IServiceSubSystemConfiguration before RSE 3.0.
+ *
+ * @since 3.0
+ */
public ISubSystemConfiguration getFactory()
{
return _factory;
}
-
+
public IConnectorService getConnectorService()
{
IHost host = getHost();
IConnectorService connectorService = _factory.getConnectorService(host);
return connectorService;
}
-
+
public IService getService()
{
IHost host = getHost();
IService service = _factory.getService(host);
return service;
}
-
+
public ServiceElement[] getChildren()
{
if (_children == null)
{
IHost host = getHost();
-
+
ServiceServiceElement serviceElement = new ServiceServiceElement(host, this, getService());
-
- IConnectorService connectorService = getConnectorService();
+
+ IConnectorService connectorService = getConnectorService();
if (connectorService != null && !(connectorService instanceof IDelegatingConnectorService))
{
_children = new ServiceElement[2];
@@ -101,9 +113,9 @@ public class FactoryServiceElement extends ServiceElement
}
}
return _children;
-
+
}
-
+
public boolean hasChildren()
{
return true;
@@ -141,7 +153,7 @@ public class FactoryServiceElement extends ServiceElement
}
}
}
-
+
public void revert()
{
ServiceElement[] children = getChildren();
diff --git a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/newconnection/ISystemNewConnectionWizardPage.java b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/newconnection/ISystemNewConnectionWizardPage.java
index e2eb26b2337..85d64908214 100644
--- a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/newconnection/ISystemNewConnectionWizardPage.java
+++ b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/newconnection/ISystemNewConnectionWizardPage.java
@@ -1,9 +1,9 @@
/*********************************************************************************
* Copyright (c) 2008 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
+ * of the Eclipse Public License v1.0 which accompanies this distribution, and is
* available at http://www.eclipse.org/legal/epl-v10.html
- *
+ *
* Contributors:
* David Dykstal (IBM) - initial contribution.
* David Dykstal (IBM) - [168976][api] move ISystemNewConnectionWizardPage from core to UI
@@ -15,12 +15,18 @@ import org.eclipse.rse.core.model.ISubSystemConfigurator;
/**
- * Interface that all subsystem configuration supplied pages contributed to the New Connection wizard must implement.
+ * Interface that all subsystem configuration supplied pages contributed to the
+ * New Connection wizard must implement. Moved from Core to UI in RSE 3.0
+ *
* @see org.eclipse.rse.ui.wizards.AbstractSystemNewConnectionWizardPage
- * @see org.eclipse.rse.ui.view.SubSystemConfigurationAdapter#getNewConnectionWizardPages(org.eclipse.rse.core.subsystems.ISubSystemConfiguration, org.eclipse.jface.wizard.IWizard)
+ * @see org.eclipse.rse.ui.view.SubSystemConfigurationAdapter#
+ * getNewConnectionWizardPages
+ * (org.eclipse.rse.core.subsystems.ISubSystemConfiguration,
+ * org.eclipse.jface.wizard.IWizard)
+ * @since 3.0
*/
public interface ISystemNewConnectionWizardPage extends ISubSystemConfigurator {
-
+
/**
* This is called when the users presses Finish. All that should be done here is validation
* of the input.
@@ -29,7 +35,7 @@ public interface ISystemNewConnectionWizardPage extends ISubSystemConfigurator {
public boolean performFinish();
/**
- * This is called frequently by the framework to decide whether to enable the Finish and Next buttons.
+ * This is called frequently by the framework to decide whether to enable the Finish and Next buttons.
*
* @return true if the page is complete and has no errors.
*/
diff --git a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/newconnection/RSEDefaultNewConnectionWizard.java b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/newconnection/RSEDefaultNewConnectionWizard.java
index a860c049c82..d212c391a28 100644
--- a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/newconnection/RSEDefaultNewConnectionWizard.java
+++ b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/newconnection/RSEDefaultNewConnectionWizard.java
@@ -436,7 +436,11 @@ public class RSEDefaultNewConnectionWizard extends RSEAbstractNewConnectionWizar
}
/**
- * Return the first additional page to show when user presses Next on the main page
+ * Return the first additional page to show when user presses Next on the
+ * main page. In RSE 3.0, the ISystemNewConnectionWizardPage return type was
+ * moved from org.eclipse.rse.core into a UI plugin.
+ *
+ * @since 3.0
*/
protected ISystemNewConnectionWizardPage getFirstAdditionalPage() {
if ((subsystemConfigurationSuppliedWizardPages != null) && (subsystemConfigurationSuppliedWizardPages.length > 0)) {
diff --git a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/registries/RSEWizardSelectionTreePatternFilter.java b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/registries/RSEWizardSelectionTreePatternFilter.java
index cf79c36bb22..c72121b8cbc 100644
--- a/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/registries/RSEWizardSelectionTreePatternFilter.java
+++ b/rse/plugins/org.eclipse.rse.ui/UI/org/eclipse/rse/ui/wizards/registries/RSEWizardSelectionTreePatternFilter.java
@@ -1,11 +1,11 @@
/*******************************************************************************
* Copyright (c) 2007 Wind River Systems, Inc. and others.
- * 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:
+ * 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:
* Uwe Stieber (Wind River) - initial API and implementation.
* Uwe Stieber (Wind River) - [209193] RSE new connection wizard shows empty categories if typing something into the filter
*******************************************************************************/
@@ -38,24 +38,27 @@ public class RSEWizardSelectionTreePatternFilter extends PatternFilter {
/**
* Constructor.
- * Creates a new pattern filter instance with the passed in
- * wizard page associated as parent.
- *
+ * Creates a new pattern filter instance with the passed in wizard page
+ * associated as parent.
+ *
* @param page The parent wizard page or null.
+ * @since 3.0
*/
public RSEWizardSelectionTreePatternFilter(WizardPage page) {
parentPage = page;
}
+
/**
* Returns the associated parent wizard parent.
- *
+ *
* @return The parent wizard page or null if none.
+ * @since 3.0
*/
protected WizardPage getParentWizardPage() {
return parentPage;
}
-
+
/* (non-Javadoc)
* @see org.eclipse.ui.dialogs.PatternFilter#isElementVisible(org.eclipse.jface.viewers.Viewer, java.lang.Object)
*/
@@ -67,7 +70,7 @@ public class RSEWizardSelectionTreePatternFilter extends PatternFilter {
// A system type must be associated with such tree element, otherwise it is filtered out
IRSESystemType systemType = ((RSENewConnectionWizardSelectionTreeElement)element).getSystemType();
if (systemType == null) return false;
-
+
// if the page is restricted to a set of system types, check on them first
WizardPage wizardPage = getParentWizardPage();
if (wizardPage instanceof RSENewConnectionWizardSelectionPage) {
@@ -76,7 +79,7 @@ public class RSEWizardSelectionTreePatternFilter extends PatternFilter {
if (!Arrays.asList(restricted).contains(systemType)) return false;
}
}
-
+
// First, adapt the system type to a viewer filter and pass on the select request
// to the viewer filter adapter if available
ViewerFilter filter = (ViewerFilter)(systemType.getAdapter(ViewerFilter.class));
@@ -87,7 +90,7 @@ public class RSEWizardSelectionTreePatternFilter extends PatternFilter {
// Second, double check if the system type passed the viewer filter but is disabled.
if (!systemType.isEnabled()) return false;
}
-
+
return super.isElementVisible(viewer, element);
}
@@ -113,8 +116,8 @@ public class RSEWizardSelectionTreePatternFilter extends PatternFilter {
}
}
-
+
return super.isLeafMatch(viewer, element);
}
-
+
}
diff --git a/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java b/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java
index 19b1aadb0d9..1f316b1596d 100644
--- a/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java
+++ b/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java
@@ -837,36 +837,45 @@ implements IAdaptable, ISubSystem, ISystemFilterPoolReferenceManagerProvider
// Methods for encoding and decoding remote objects for drag and drop, and clipboard copy
// --------------------------------------------------------------------------------------
+
+ // --------------
+ // Methods for encoding and decoding remote objects for drag and drop, and
+ // clipboard copy
+ // ------------------------------------------------------------------------
+ // --------------
+
/**
* Return the remote object that corresponds to the specified unique ID.
*
- * Since the abstract subsystem implementation does not know anything - * about the specific kinds of resources managed by concrete - * implementations, this method can only resolve filter references. - *
- * subsystem implementations must override this method
- * in order to resolve IDs for the remote objects they manage,
- * to support drag and drop, clipboard copy and other remote object
- * resolving schemes.
- * Extenders that want to support filters should call
- * super.getObjectWithAbsoluteName(key)
- * when they do not find a reference for the key themselves.
+ * Since the abstract subsystem implementation does not know anything about
+ * the specific kinds of resources managed by concrete implementations, this
+ * method can only resolve filter references.
+ *
+ * subsystem implementations must override this method in order to
+ * resolve IDs for the remote objects they manage, to support drag and drop,
+ * clipboard copy and other remote object resolving schemes.
+ * Extenders that want to support filters should call
+ * super.getObjectWithAbsoluteName(key) when they do not find a
+ * reference for the key themselves.
*
null.
+ * @see org.eclipse.rse.core.subsystems.IRemoteObjectResolver#
+ * getObjectWithAbsoluteName(String, IProgressMonitor)
+ *
+ * @param key the unique id of the remote object. Must not be
+ * null.
* @param monitor the progress monitor
- * @return the remote object instance, or null if no
- * object is found with the given id.
- * @throws Exception in case an error occurs contacting the remote
- * system while retrieving the requested remote object.
- * Extenders are encouraged to throw {@link SystemMessageException}
- * in order to support good user feedback in case of errors.
- * Since exceptions should only occur while retrieving new
- * remote objects during startup, clients are typically allowed
- * to ignore these exceptions and treat them as if the remote
- * object were simply not there.
+ * @return the remote object instance, or null if no object is
+ * found with the given id.
+ * @throws Exception in case an error occurs contacting the remote system
+ * while retrieving the requested remote object. Extenders are
+ * encouraged to throw {@link SystemMessageException} in order to
+ * support good user feedback in case of errors. Since exceptions
+ * should only occur while retrieving new remote objects during
+ * startup, clients are typically allowed to ignore these exceptions
+ * and treat them as if the remote object were simply not there.
+ * @since 3.0
*/
public Object getObjectWithAbsoluteName(String key, IProgressMonitor monitor) throws Exception
{
@@ -1697,7 +1706,7 @@ implements IAdaptable, ISubSystem, ISystemFilterPoolReferenceManagerProvider
msg = SubSystemConfiguration.getConnectingMessage(getHostName(), getConnectorService().getPort());
SystemBasePlugin.logInfo(msg);
- if (!isOffline()){
+ if (!isOffline()){
if (!implicitConnect(true, mon, msg, totalWorkUnits)){
String msgTxt = NLS.bind(CommonMessages.MSG_CONNECT_FAILED, getHostName());
throw new Exception(msgTxt);
@@ -3182,34 +3191,47 @@ implements IAdaptable, ISubSystem, ISystemFilterPoolReferenceManagerProvider
/* Service Subsystem support */
/**
- * Perform the subsystem specific processing required to complete a subsystem configuration switch for a
- * service subsystem. The subsystem will typically query this configuration for interesting properties or
- * policies. It should also reset any state to a fresh start.
- * This supplied implementation does nothing. Subclasses may override if they implement a service subsystem.
- * @param newConfiguration the configuration this subsystem should use from this point.
+ * Perform the subsystem specific processing required to complete a
+ * subsystem configuration switch for a service subsystem. The subsystem
+ * will typically query this configuration for interesting properties or
+ * policies. It should also reset any state to a fresh start. This supplied
+ * implementation does nothing. Subclasses may override if they implement a
+ * service subsystem.
+ *
+ * @param newConfiguration the configuration this subsystem should use from
+ * this point.
+ * @since 3.0
*/
protected void internalSwitchSubSystemConfiguration(ISubSystemConfiguration newConfiguration) {
}
/**
- * Determine if a service subsystem is capable of switching to this new configuration.
- * This is usually a test of this configuration's type against the type expected by this subsystem.
- * This supplied implementation returns false. Subclasses should override if they implement a service subsystem.
+ * Determine if a service subsystem is capable of switching to this new
+ * configuration. This is usually a test of this configuration's type
+ * against the type expected by this subsystem. This supplied implementation
+ * returns false. Subclasses should override if they implement a service
+ * subsystem.
+ *
* @param configuration the configuration to which this subsystem may switch
- * @return true if this subsystem is capable of switching to this configuration, false otherwise. This implementation
- * returns false.
+ * @return true if this subsystem is capable of switching to this
+ * configuration, false otherwise. This implementation returns false.
* @see ISubSystem#canSwitchTo(ISubSystemConfiguration)
+ * @since 3.0
*/
public boolean canSwitchTo(ISubSystemConfiguration configuration) {
return false;
}
/**
- * Switch to use another subsystem configuration. This default implementation will test if the subsystem is a
- * service subsystem and if the subsystem is compatible with the suggested configuration. If it is the switch will
- * be performed and internalSwitchSubSystemConfiguration will be called.
+ * Switch to use another subsystem configuration. This default
+ * implementation will test if the subsystem is a service subsystem and if
+ * the subsystem is compatible with the suggested configuration. If it is
+ * the switch will be performed and internalSwitchSubSystemConfiguration
+ * will be called.
+ *
* @see ISubSystem#switchServiceFactory(ISubSystemConfiguration)
* @see #internalSwitchSubSystemConfiguration(ISubSystemConfiguration)
+ * @since 3.0
*/
public void switchServiceFactory(final ISubSystemConfiguration config) {
if (config != getSubSystemConfiguration() && canSwitchTo(config)) {
@@ -3227,9 +3249,12 @@ implements IAdaptable, ISubSystem, ISystemFilterPoolReferenceManagerProvider
/**
* Return the service type for this subsystem.
- * @return the default implementation returns null. Subclasses that implement service subsystems
- * should return a type as specified in the interface.
- * @see org.eclipse.rse.core.subsystems.ISubSystem#getServiceType()
+ *
+ * @return the default implementation returns null. Subclasses that
+ * implement service subsystems should return a type as specified in the
+ * interface.
+ * @see ISubSystem#getServiceType()
+ * @since 3.0
*/
public Class getServiceType() {
return null;
diff --git a/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystemConfiguration.java b/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystemConfiguration.java
index 9bfb206ed9a..6e5b1e68588 100644
--- a/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystemConfiguration.java
+++ b/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystemConfiguration.java
@@ -960,25 +960,33 @@ public abstract class SubSystemConfiguration implements ISubSystemConfiguration
}
/**
- * Creates a new subsystem instance that is associated with the given connection object.
- * SystemRegistryImpl calls this when a new connection is created, and appliesToSystemType returns true.
+ * Creates a new subsystem instance that is associated with the given
+ * connection object. SystemRegistryImpl calls this when a new connection is
+ * created, and appliesToSystemType returns true.
* * This method doe sthe following: *
true if deferred queries are supported.
- * @see org.eclipse.rse.core.subsystems.ISubSystemConfiguration#supportsDeferredQueries()
+ * @see ISubSystemConfiguration#supportsDeferredQueries()
*/
public boolean supportsDeferredQueries()
{
@@ -2792,44 +2809,65 @@ public abstract class SubSystemConfiguration implements ISubSystemConfiguration
*/
/**
- * This default implementation does nothing.
- * Service subsystems must override as defined in the interface.
- * @see org.eclipse.rse.core.subsystems.ISubSystemConfiguration#setConnectorService(org.eclipse.rse.core.model.IHost, org.eclipse.rse.core.subsystems.IConnectorService)
+ * {@inheritDoc}
+ * + * This default implementation does nothing. Service subsystems must + * override as defined in the interface. + * + * @see ISubSystemConfiguration#setConnectorService(IHost, + * IConnectorService) + * @since org.eclipse.rse.core 3.0 */ public void setConnectorService(IHost host, IConnectorService connectorService) { } /** - * This default implementation returns null. - * Service subsystem configurations must override as defined in the interface. - * @see org.eclipse.rse.core.subsystems.ISubSystemConfiguration#getConnectorService(org.eclipse.rse.core.model.IHost) + * {@inheritDoc} + *
+ * This default implementation returns null. Service subsystem
+ * configurations must override as defined in the interface.
+ *
+ * @see ISubSystemConfiguration#getConnectorService(IHost)
+ * @since org.eclipse.rse.core 3.0
*/
public IConnectorService getConnectorService(IHost host) {
return null;
}
/**
- * This default implementation returns null.
- * Service subsystem configurations must override as defined in the interface.
- * @see org.eclipse.rse.core.subsystems.ISubSystemConfiguration#getServiceType()
+ * {@inheritDoc}
+ *
+ * This default implementation returns null. Service subsystem
+ * configurations must override as defined in the interface.
+ *
+ * @see ISubSystemConfiguration#getServiceType()
+ * @since org.eclipse.rse.core 3.0
*/
public Class getServiceType() {
return null;
}
/**
- * This default implementation returns null.
- * Service subsystem configurations must override as defined in the interface.
- * @see org.eclipse.rse.core.subsystems.ISubSystemConfiguration#getServiceImplType()
+ * {@inheritDoc}
+ *
+ * This default implementation returns null. Service subsystem
+ * configurations must override as defined in the interface.
+ *
+ * @see ISubSystemConfiguration#getServiceImplType()
+ * @since org.eclipse.rse.core 3.0
*/
public Class getServiceImplType() {
return null;
}
/**
- * This default implementation returns null.
- * Service subsystem configurations must override as defined in the interface.
- * @see org.eclipse.rse.core.subsystems.ISubSystemConfiguration#getService(org.eclipse.rse.core.model.IHost)
+ * {@inheritDoc}
+ *
+ * This default implementation returns null. Service subsystem
+ * configurations must override as defined in the interface.
+ *
+ * @see ISubSystemConfiguration#getService(IHost)
+ * @since org.eclipse.rse.core 3.0
*/
public IService getService(IHost host) {
return null;