mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-07-04 07:35:24 +02:00
[226969][cleanup] Use {@inheritDoc} rather than duplicating comment
This commit is contained in:
parent
7b9b88c272
commit
a2d40ccafa
4 changed files with 33 additions and 40 deletions
|
@ -158,8 +158,7 @@ public abstract class AbstractRSESystemType extends PlatformObject implements IR
|
|||
}
|
||||
|
||||
/**
|
||||
* Tests whether the system type is currently enabled.
|
||||
*
|
||||
* {@inheritDoc}
|
||||
* @see IRSESystemType#isEnabled()
|
||||
* @since org.eclipse.rse.core 3.0
|
||||
*/
|
||||
|
|
|
@ -478,9 +478,7 @@ public abstract class AbstractConnectorService extends RSEModelObject implements
|
|||
}
|
||||
|
||||
/**
|
||||
* Sets the attribute for this connector service instance that denies a
|
||||
* password to be saved.
|
||||
*
|
||||
* {@inheritDoc}
|
||||
* @see IConnectorService#setDenyPasswordSave(boolean)
|
||||
* @since org.eclipse.rse.core 3.0
|
||||
*/
|
||||
|
@ -493,10 +491,7 @@ public abstract class AbstractConnectorService extends RSEModelObject implements
|
|||
}
|
||||
|
||||
/**
|
||||
* Retrieves the value of the "DENY_PASSWORD_SAVE" property of this
|
||||
* connector service.
|
||||
*
|
||||
* @return <code>true</code> if password saving is denied.
|
||||
* {@inheritDoc}
|
||||
* @see IConnectorService#getDenyPasswordSave()
|
||||
* @since org.eclipse.rse.core 3.0
|
||||
*/
|
||||
|
|
|
@ -786,10 +786,7 @@ public abstract class AbstractDelegatingConnectorService implements IDelegatingC
|
|||
}
|
||||
|
||||
/**
|
||||
* Sets the attribute for this connector service instance that denies a
|
||||
* password to be saved.
|
||||
*
|
||||
* @see IConnectorService#setDenyPasswordSave(boolean)
|
||||
* {@inheritDoc}
|
||||
* @since org.eclipse.rse.core 3.0
|
||||
*/
|
||||
public int setDenyPasswordSave(boolean deny) {
|
||||
|
@ -802,11 +799,7 @@ public abstract class AbstractDelegatingConnectorService implements IDelegatingC
|
|||
}
|
||||
|
||||
/**
|
||||
* Retrieves the value of the "DENY_PASSWORD_SAVE" property of this
|
||||
* connector service. If the value has never been set, this will return
|
||||
* false.
|
||||
*
|
||||
* @return true if password saving is denied.
|
||||
* {@inheritDoc}
|
||||
* @since org.eclipse.rse.core 3.0
|
||||
*/
|
||||
public boolean getDenyPasswordSave() {
|
||||
|
|
|
@ -85,21 +85,26 @@ public interface IConnectorService extends IRSEModelObject {
|
|||
public boolean isConnected();
|
||||
|
||||
/**
|
||||
* Connects to the remote system.
|
||||
* @param monitor a monitor for tracking the progress and canceling a connect
|
||||
* operation.
|
||||
* @throws Exception an exception of there is a failure to connect.
|
||||
* Typically, this will be a {@link SystemMessageException}.
|
||||
* @since 3.0 throws an {@link OperationCanceledException} if the connect was cancelled by the user
|
||||
* Connect to the remote system.
|
||||
*
|
||||
* @param monitor a monitor for tracking the progress and canceling a
|
||||
* connect operation.
|
||||
* @throws OperationCanceledException if the connect was cancelled by the
|
||||
* user
|
||||
* @throws Exception if there is a failure connecting. Typically, this will
|
||||
* be a {@link SystemMessageException}.
|
||||
* @since org.eclipse.rse.core 3.0 throws OperationCanceledException instead
|
||||
* of InterruptedException
|
||||
*/
|
||||
public void connect(IProgressMonitor monitor) throws Exception;
|
||||
|
||||
/**
|
||||
* Disconnects from the remote system.
|
||||
* @param monitor a monitor for tracking the progress and canceling a disconnect
|
||||
* operation.
|
||||
* @throws Exception an exception of the disconnect fails.
|
||||
* Typically, this will be a {@link SystemMessageException}.
|
||||
* Disconnect from the remote system.
|
||||
*
|
||||
* @param monitor a monitor for tracking the progress and canceling a
|
||||
* disconnect operation.
|
||||
* @throws Exception an exception of the disconnect fails. Typically, this
|
||||
* will be a {@link SystemMessageException}.
|
||||
*/
|
||||
public void disconnect(IProgressMonitor monitor) throws Exception;
|
||||
|
||||
|
@ -270,18 +275,19 @@ public interface IConnectorService extends IRSEModelObject {
|
|||
public void clearCredentials();
|
||||
|
||||
/**
|
||||
* Acquire the credentials for this connector service.
|
||||
* Acquisition may be temporarily suppressed
|
||||
* by using the {@link #setSuppressed(boolean)}.
|
||||
* Acquire the credentials for this connector service. Acquisition may be
|
||||
* temporarily suppressed by using the {@link #setSuppressed(boolean)}.
|
||||
* <p>
|
||||
* Implementations may retain a remembered credentials or
|
||||
* use this to acquire the credentials using some implementation defined means.
|
||||
* Implementations may retain a remembered credentials or use this to
|
||||
* acquire the credentials using some implementation defined means.
|
||||
* <p>
|
||||
* Throws {@link OperationCanceledException} if acquisition of the
|
||||
* credentials is cancelled or is being suppressed.
|
||||
* @param refresh if true will force the connector service to discard
|
||||
* any remembered value and reacquire the credentials.
|
||||
* @since 3.0 throws OperationCanceledException instead of InterruptedException
|
||||
*
|
||||
* @param refresh if true will force the connector service to discard any
|
||||
* remembered value and reacquire the credentials.
|
||||
* @throws OperationCanceledException if acquisition of the credentials is
|
||||
* cancelled or is being suppressed.
|
||||
* @since org.eclipse.rse.core 3.0 throws OperationCanceledException instead
|
||||
* of InterruptedException
|
||||
*/
|
||||
public void acquireCredentials(boolean refresh) throws OperationCanceledException;
|
||||
|
||||
|
@ -395,7 +401,7 @@ public interface IConnectorService extends IRSEModelObject {
|
|||
* false. If set to true, it will clear any saved passwords for this system
|
||||
* and not allow any further passwords to be stored. This property of a
|
||||
* system is persistent from session to session, but is not sharable.
|
||||
*
|
||||
*
|
||||
* @param deny If true, forget any saved passwords and do not allow any
|
||||
* others to be saved. If false, allow passwords to be saved in
|
||||
* the keyring.
|
||||
|
|
Loading…
Add table
Reference in a new issue