diff options
| author | Andrey Loskutov | 2017-01-09 13:12:58 +0000 |
|---|---|---|
| committer | Andrey Loskutov | 2017-01-13 20:56:39 +0000 |
| commit | ebb2566c95427e5c7cffd5e27f1e910b0a187b17 (patch) | |
| tree | f9b87db9c4ccf476dfb8c8d4b5fcfcfd3f871bbb /org.eclipse.debug.core | |
| parent | 1c1d17b82a223fb8fcc69b4883a71b8744899ccb (diff) | |
| download | eclipse.platform.debug-ebb2566c95427e5c7cffd5e27f1e910b0a187b17.tar.gz eclipse.platform.debug-ebb2566c95427e5c7cffd5e27f1e910b0a187b17.tar.xz eclipse.platform.debug-ebb2566c95427e5c7cffd5e27f1e910b0a187b17.zip | |
Bug 510100 - [cleanup] Get rid of trailing white space in platform.debugY20170119-1000I20170119-2000I20170119-1010I20170119-0345I20170118-2000I20170118-1215I20170117-2000I20170116-2000I20170115-2000I20170114-2000I20170113-2000
Also enabled "cleanup whitespace on save" actions for debug.ui and
debug.tests bundles.
Change-Id: I755b879ab1d49144a1bec3f4318dbb8b29521bb3
Signed-off-by: Andrey Loskutov <loskutov@gmx.de>
Diffstat (limited to 'org.eclipse.debug.core')
87 files changed, 722 insertions, 722 deletions
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugException.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugException.java index b1a7c3dec..8cf814a4b 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugException.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugException.java @@ -11,7 +11,7 @@ package org.eclipse.debug.core; - + import org.eclipse.core.runtime.CoreException; import org.eclipse.core.runtime.IStatus; @@ -19,7 +19,7 @@ import org.eclipse.core.runtime.IStatus; /** * A checked exception representing a failure. * <p> - * Defines status codes relevant to the debug plug-in. When a + * Defines status codes relevant to the debug plug-in. When a * debug exception is thrown, it contains a status object describing * the cause of the exception. The status objects originating from the * debug plug-in use the codes defined in this class. @@ -27,19 +27,19 @@ import org.eclipse.core.runtime.IStatus; * @see IStatus * @noextend This class is not intended to be subclassed by clients. */ -public class DebugException extends CoreException { - +public class DebugException extends CoreException { + /** * All objects that can be serialized should have a stable serialVersionUID */ private static final long serialVersionUID = 1L; - + /** * Indicates a request made of a debug element has failed * on the target side. */ public static final int TARGET_REQUEST_FAILED = 5010; - + /** * Indicates a request is not supported by the capabilities of a debug element. * For example, a request was made to terminate an element that does not @@ -58,23 +58,23 @@ public class DebugException extends CoreException { * Indicates an internal error. This is an unexpected state. */ public static final int INTERNAL_ERROR = 5013; - - /** + + /** * Indicates an improperly configured breakpoint. Breakpoints have a minimal * set of required attributes as defined by the breakpoint manager. * * @see IBreakpointManager */ public static final int CONFIGURATION_INVALID = 5014; - + /** * Indicates a launch configuration could not be restored because its * launch configuration type definition is missing. - * + * * @since 3.0 */ public static final int MISSING_LAUNCH_CONFIGURATION_TYPE = 5020; - + /** * Constructs a new debug exception with the given status object. * diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IBreakpointListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IBreakpointListener.java index 49e4bef97..159e063cd 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IBreakpointListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IBreakpointListener.java @@ -50,7 +50,7 @@ public interface IBreakpointListener { * @since 2.0 */ public void breakpointRemoved(IBreakpoint breakpoint, IMarkerDelta delta); - + /** * Notifies this listener that an attribute of the given breakpoint has * changed, as described by the delta. diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IBreakpointsListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IBreakpointsListener.java index 6e0aa6ef5..e45fd4f79 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IBreakpointsListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IBreakpointsListener.java @@ -52,7 +52,7 @@ public interface IBreakpointsListener { * @see org.eclipse.core.resources.IMarkerDelta */ public void breakpointsRemoved(IBreakpoint[] breakpoints, IMarkerDelta[] deltas); - + /** * Notifies this listener that the given breakpoints have * changed, as described by the corresponding deltas. diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IDebugEventSetListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IDebugEventSetListener.java index 683270baa..160d1c348 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IDebugEventSetListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IDebugEventSetListener.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -17,7 +17,7 @@ package org.eclipse.debug.core; * <p> * When more than one event is reported, each event has occurred at the * same location in a target program. For example, a breakpoint may - * reside at the same location at which a step request completes. In + * reside at the same location at which a step request completes. In * this case the breakpoint event and step end event are reported together * in the same event set. * </p> diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionListener.java index d82e6bfba..9ab5b2baf 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionListener.java @@ -41,7 +41,7 @@ public interface IExpressionListener { * @param expression the removed expression */ public void expressionRemoved(IExpression expression); - + /** * Notifies this listener that the given expression has * changed. diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionManager.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionManager.java index fc42306fa..72c161135 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionManager.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionManager.java @@ -41,7 +41,7 @@ public interface IExpressionManager { * @param expression the expression to add */ public void addExpression(IExpression expression); - + /** * Adds the given expressions to the collection of registered expressions * in the workspace and notifies all registered listeners. Has no effect @@ -51,33 +51,33 @@ public interface IExpressionManager { * @since 2.1 */ public void addExpressions(IExpression[] expressions); - + /** * Creates and returns a new watch expression with the * given text. The returned expression is <b>not</b> added to * this manager. - * + * * @return new watch expression * @param expressionText the text for the new expression * @since 3.0 */ public IWatchExpression newWatchExpression(String expressionText); - + /** - * Returns a collection of all registered expressions, + * Returns a collection of all registered expressions, * possibly empty. * * @return an array of expressions */ public IExpression[] getExpressions(); - + /** * Returns whether there are any registered expressions - * + * * @return whether there are any registered expressions */ public boolean hasExpressions(); - + /** * Returns a collection of all expressions registered for the * given debug model,possibly empty. @@ -86,7 +86,7 @@ public interface IExpressionManager { * @return an array of expressions */ public IExpression[] getExpressions(String modelIdentifier); - + /** * Removes the given expression from the expression manager, * and notifies all registered listeners. Has no effect if the @@ -95,7 +95,7 @@ public interface IExpressionManager { * @param expression the expression to remove */ public void removeExpression(IExpression expression); - + /** * Removes the given expressions from the collection of registered expressions * in the workspace and notifies all registered listeners. Has no effect @@ -104,7 +104,7 @@ public interface IExpressionManager { * @param expressions the expressions to remove * @since 2.1 */ - public void removeExpressions(IExpression[] expressions); + public void removeExpressions(IExpression[] expressions); /** * Adds the given listener to the collection of registered expression listeners. @@ -118,10 +118,10 @@ public interface IExpressionManager { * Removes the given listener from the collection of registered expression listeners. * Has no effect if an identical listener is not already registered. * - * @param listener the listener to remove + * @param listener the listener to remove */ public void removeExpressionListener(IExpressionListener listener); - + /** * Adds the given listener to the collection of registered expression listeners. * Has no effect if an identical listener is already registered. @@ -135,15 +135,15 @@ public interface IExpressionManager { * Removes the given listener from the collection of registered expression listeners. * Has no effect if an identical listener is not already registered. * - * @param listener the listener to remove + * @param listener the listener to remove * @since 2.1 */ public void removeExpressionListener(IExpressionsListener listener); - + /** * Returns a new watch expression delegate for the given debug * model or <code>null</code> if no delegate is available. - * + * * @param id the unique identifier of a debug model for which a * watch expression delegate has been contributed * @return a watch expression delegate associated with the given model @@ -152,17 +152,17 @@ public interface IExpressionManager { * @see IWatchExpressionDelegate */ public IWatchExpressionDelegate newWatchExpressionDelegate(String id); - + /** * Returns whether a watch expression delegate has been contributed for * the given debug model. - * + * * @param id the unique identifier of a debug model * @return whether a watch expression delegate has been contributed for * the given debug model * @since 3.1 * @see IWatchExpressionDelegate - */ + */ public boolean hasWatchExpressionDelegate(String id); } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionsListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionsListener.java index a73a72eb2..aa78eb85e 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionsListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IExpressionsListener.java @@ -44,7 +44,7 @@ public interface IExpressionsListener { * @param expressions the removed expressions */ public void expressionsRemoved(IExpression[] expressions); - + /** * Notifies this listener that the given expressions have * changed. diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunch.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunch.java index 96b595e30..b2940024e 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunch.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunch.java @@ -39,7 +39,7 @@ public interface ILaunch extends ITerminate, IAdaptable { public Object[] getChildren(); /** * Returns the primary (first) debug target associated with this launch, or <code>null</code> - * if no debug target is associated with this launch. All debug targets + * if no debug target is associated with this launch. All debug targets * associated with this launch may be retrieved by * <code>getDebugTargets()</code>. * @@ -54,7 +54,7 @@ public interface ILaunch extends ITerminate, IAdaptable { * @return array of processes */ public IProcess[] getProcesses(); - + /** * Returns all the debug targets associated with this launch, * or an empty collection if no debug targets are associated @@ -65,7 +65,7 @@ public interface ILaunch extends ITerminate, IAdaptable { * @since 2.0 */ public IDebugTarget[] getDebugTargets(); - + /** * Adds the given debug target to this launch. Has no effect * if the given debug target is already associated with this @@ -75,8 +75,8 @@ public interface ILaunch extends ITerminate, IAdaptable { * @param target debug target to add to this launch * @since 2.0 */ - public void addDebugTarget(IDebugTarget target); - + public void addDebugTarget(IDebugTarget target); + /** * Removes the given debug target from this launch. Has no effect * if the given debug target is not already associated with this @@ -86,8 +86,8 @@ public interface ILaunch extends ITerminate, IAdaptable { * @param target debug target to remove from this launch * @since 2.0 */ - public void removeDebugTarget(IDebugTarget target); - + public void removeDebugTarget(IDebugTarget target); + /** * Adds the given process to this launch. Has no effect * if the given process is already associated with this @@ -97,8 +97,8 @@ public interface ILaunch extends ITerminate, IAdaptable { * @param process the process to add to this launch * @since 2.0 */ - public void addProcess(IProcess process); - + public void addProcess(IProcess process); + /** * Removes the given process from this launch. Has no effect * if the given process is not already associated with this @@ -108,8 +108,8 @@ public interface ILaunch extends ITerminate, IAdaptable { * @param process the process to remove from this launch * @since 2.0 */ - public void removeProcess(IProcess process); - + public void removeProcess(IProcess process); + /** * Returns the source locator to use for locating source elements for * the debug target associated with this launch, or <code>null</code> @@ -118,7 +118,7 @@ public interface ILaunch extends ITerminate, IAdaptable { * @return the source locator */ public ISourceLocator getSourceLocator(); - + /** * Sets the source locator to use for locating source elements for * the debug target associated with this launch, or <code>null</code> @@ -128,7 +128,7 @@ public interface ILaunch extends ITerminate, IAdaptable { * @since 2.0 */ public void setSourceLocator(ISourceLocator sourceLocator); - + /** * Returns the mode of this launch - one of the mode constants defined by * the launch manager. @@ -137,16 +137,16 @@ public interface ILaunch extends ITerminate, IAdaptable { * @see ILaunchManager */ public String getLaunchMode(); - + /** * Returns the configuration that was launched, or <code>null</code> * if no configuration was launched. - * + * * @return the launched configuration or <code>null</code> * @since 2.0 */ public ILaunchConfiguration getLaunchConfiguration(); - + /** * Sets the value of a client defined attribute. * @@ -155,7 +155,7 @@ public interface ILaunch extends ITerminate, IAdaptable { * @since 2.0 */ public void setAttribute(String key, String value); - + /** * Returns the value of a client defined attribute. * @@ -163,12 +163,12 @@ public interface ILaunch extends ITerminate, IAdaptable { * @return value the attribute value, or <code>null</code> if undefined * @since 2.0 */ - public String getAttribute(String key); - + public String getAttribute(String key); + /** * Returns whether this launch contains at least one process * or debug target. - * + * * @return whether this launch contains at least one process * or debug target * @since 2.0 diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationListener.java index dc7b84fa4..e1a59f933 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationListener.java @@ -10,7 +10,7 @@ *******************************************************************************/ package org.eclipse.debug.core; - + /** * Notified when a launch configuration is created, * deleted, or changed. @@ -20,34 +20,34 @@ package org.eclipse.debug.core; * @since 2.0 */ public interface ILaunchConfigurationListener { - + /** * The given launch configuration has been created. - * + * * @param configuration the newly created launch configuration */ public void launchConfigurationAdded(ILaunchConfiguration configuration); - + /** * The given launch configuration has changed in some way. * The configuration may be a working copy. - * + * * @param configuration the launch configuration that has * changed */ public void launchConfigurationChanged(ILaunchConfiguration configuration); - + /** * The given launch configuration has been deleted. * <p> - * The launch configuration no longer exists. Data stored + * The launch configuration no longer exists. Data stored * in the configuration can no longer be accessed, however * handle-only attributes of the launch configuration * can be retrieved. * </p> - * + * * @param configuration the deleted launch configuration */ - public void launchConfigurationRemoved(ILaunchConfiguration configuration); + public void launchConfigurationRemoved(ILaunchConfiguration configuration); } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationMigrationDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationMigrationDelegate.java index ce4e3d014..328c722fc 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationMigrationDelegate.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationMigrationDelegate.java @@ -15,10 +15,10 @@ import org.eclipse.core.runtime.CoreException; /** * Responsible for migrating launch configurations between different versions of Eclipse. - * A migration delegate is contributed as an optional attribute of a + * A migration delegate is contributed as an optional attribute of a * <code>launchConfigurationType</code> extension and is responsible for identifying * migration candidates and migrating launch configurations of that type. - * <p> + * <p> * For example, since 3.2 launch configurations may have resources mapped to them. A migration * delegate could assign appropriate resources to a launch configuration create in an earlier * version. @@ -31,22 +31,22 @@ import org.eclipse.core.runtime.CoreException; public interface ILaunchConfigurationMigrationDelegate { /** - * Returns whether the given launch configuration requires migration. - * - * @param candidate potential migration candidate + * Returns whether the given launch configuration requires migration. + * + * @param candidate potential migration candidate * @return whether the given launch configuration requires migration * @throws CoreException if an exception occurs determining the status of the * given configuration */ public boolean isCandidate(ILaunchConfiguration candidate) throws CoreException; - + /** * Migrates the given launch configuration to be compatible with the current tooling. - * + * * @param candidate the candidate to be migrated, which can be a launch configuration * or working copy * @throws CoreException if an exception occurs during migration */ public void migrate(ILaunchConfiguration candidate) throws CoreException; - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchListener.java index 427b6f4f9..ca9f041b7 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchListener.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -22,7 +22,7 @@ package org.eclipse.debug.core; * @see org.eclipse.debug.core.ILaunch * @see org.eclipse.debug.core.ILaunchesListener */ -public interface ILaunchListener { +public interface ILaunchListener { /** * Notifies this listener that the specified * launch has been removed. @@ -34,18 +34,18 @@ public interface ILaunchListener { /** * Notifies this listener that the specified launch * has been added. - * + * * @param launch the newly added launch * @since 2.0 */ - public void launchAdded(ILaunch launch); + public void launchAdded(ILaunch launch); /** * Notifies this listener that the specified launch * has changed. For example, a process or debug target * has been added to the launch. - * + * * @param launch the changed launch * @since 2.0 */ - public void launchChanged(ILaunch launch); + public void launchChanged(ILaunch launch); } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchMode.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchMode.java index 9f9849d9a..2f3c1debf 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchMode.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchMode.java @@ -32,21 +32,21 @@ package org.eclipse.debug.core; * @noextend This interface is not intended to be extended by clients. */ public interface ILaunchMode { - + /** * Returns the unique identifier for this launch mode. - * + * * @return the unique identifier for this launch mode */ public String getIdentifier(); - + /** * Returns a human readable label for this launch mode. - * + * * @return a human readable label for this launch mode */ public String getLabel(); - + /** * Returns a human readable label for this launch mode when used in a * cascade menu. For example, "Run As". Allows the label to be diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchesListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchesListener.java index e6c8232b4..12d84bfd0 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchesListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchesListener.java @@ -25,7 +25,7 @@ package org.eclipse.debug.core; * Clients may implement this interface. * </p> * <p> - * Clients may also implement the extension interface {@link ILaunchesListener2} for + * Clients may also implement the extension interface {@link ILaunchesListener2} for * notification of more than one launch being terminated. * </p> * @see org.eclipse.debug.core.ILaunch @@ -34,7 +34,7 @@ package org.eclipse.debug.core; * @see ILaunchesListener2 * @since 2.1 */ -public interface ILaunchesListener { +public interface ILaunchesListener { /** * Notifies this listener that the specified * launches have been removed. @@ -45,16 +45,16 @@ public interface ILaunchesListener { /** * Notifies this listener that the specified launches * have been added. - * + * * @param launches the newly added launch objects */ - public void launchesAdded(ILaunch[] launches); + public void launchesAdded(ILaunch[] launches); /** * Notifies this listener that the specified launches * have changed. For example, a process or debug target * has been added to a launch. - * + * * @param launches the changed launch object */ - public void launchesChanged(ILaunch[] launches); + public void launchesChanged(ILaunch[] launches); } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchesListener2.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchesListener2.java index 7bf7022ca..043d7558f 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchesListener2.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchesListener2.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -20,10 +20,10 @@ package org.eclipse.debug.core; * @since 3.0 */ public interface ILaunchesListener2 extends ILaunchesListener { - + /** * Notification that the given launches have terminated. - * + * * @param launches the launches that have terminated */ public void launchesTerminated(ILaunch[] launches); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILogicalStructureProvider.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILogicalStructureProvider.java index df4fb4872..9fb9c48e2 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILogicalStructureProvider.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILogicalStructureProvider.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -38,10 +38,10 @@ import org.eclipse.debug.core.model.IValue; * @see org.eclipse.debug.core.ILogicalStructureType */ public interface ILogicalStructureProvider { - + /** * Returns the logical structure types which are applicable to the given value. - * + * * @param value value for which logical structure types are being requested * @return the logical structure types which are applicable to the given value */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILogicalStructureType.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILogicalStructureType.java index ae049d52b..617f8daeb 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILogicalStructureType.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILogicalStructureType.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -17,7 +17,7 @@ import org.eclipse.debug.core.model.ILogicalStructureTypeDelegate2; * Provides a value representing the logical structure of a raw implementation value * from a debug model. Logical structures are useful for navigating complex data * structures. Logical structure types are contributed via extensions in plug-in XML, - * and provide a delegate for performing logical value computation. Logical + * and provide a delegate for performing logical value computation. Logical * structure types can be retrieved from the <code>DebugPlugin</code>. * <p> * Following is example plug-in XML to define a logical structure type. @@ -36,7 +36,7 @@ import org.eclipse.debug.core.model.ILogicalStructureTypeDelegate2; * The attributes are specified as follows: * <ul> * <li>id - unique identifier for this logical structure type</li> - * <li>class - fully qualified name of class that implements + * <li>class - fully qualified name of class that implements * <code>ILogicalStructureTypeDelegate</code></li> * <li>modelIdentifier - identifier of the debug model this logical structure * type is associated with</li> @@ -56,7 +56,7 @@ import org.eclipse.debug.core.model.ILogicalStructureTypeDelegate2; * @see org.eclipse.debug.core.ILogicalStructureProvider */ public interface ILogicalStructureType extends ILogicalStructureTypeDelegate, ILogicalStructureTypeDelegate2 { - + /** * Returns a simple description of the logical structure provided by this * structure type. @@ -64,16 +64,16 @@ public interface ILogicalStructureType extends ILogicalStructureTypeDelegate, IL * Since 3.1, this method can return <code>null</code> if this logical structure * type's delegate implements <code>ILogicalStructureTypeDelegate2</code>. * </p> - * + * * @return a simple description of the logical structure provided by this * structure type, possibly <code>null</code> */ public String getDescription(); - + /** * Returns this logical structure type's unique identifier, as defined * in plug-in XML. - * + * * @return this logical structure type's unique identifier */ public String getId(); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IMemoryBlockListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IMemoryBlockListener.java index 65ff4d535..a1908c70a 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IMemoryBlockListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IMemoryBlockListener.java @@ -23,11 +23,11 @@ import org.eclipse.debug.core.model.IMemoryBlock; * @since 3.1 */ public interface IMemoryBlockListener { - + /** * Notification the given memory blocks have been added to the * memory block manager. - * + * * @param memory blocks added to the memory block manager */ void memoryBlocksAdded(IMemoryBlock[] memory); @@ -35,9 +35,9 @@ public interface IMemoryBlockListener { /** * Notification the given memory blocks have been removed from * the memory block manager. - * + * * @param memory blocks removed from the memory block manager */ void memoryBlocksRemoved(IMemoryBlock[] memory); - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IMemoryBlockManager.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IMemoryBlockManager.java index 3c572aae5..a1a55f0fd 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IMemoryBlockManager.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IMemoryBlockManager.java @@ -18,8 +18,8 @@ import org.eclipse.debug.core.model.IMemoryBlockRetrieval; /** * Manages registered memory blocks in the workspace. Clients - * interested in notification of the addition and removal of - * memory blocks may register as a memory block listener with + * interested in notification of the addition and removal of + * memory blocks may register as a memory block listener with * the memory block manager. * @see org.eclipse.debug.core.model.IMemoryBlock * @see org.eclipse.debug.core.IMemoryBlockListener @@ -33,61 +33,61 @@ public interface IMemoryBlockManager { * Adds the given memory blocks to the memory block manager. * Registered memory block listeners are notified of the additions. * Has no effect on memory blocks that are already registered. - * + * * @param memoryBlocks memory blocks to add */ public void addMemoryBlocks(IMemoryBlock[] memoryBlocks); - + /** * Removes the given memory blocks from the memory block manager. * Registered memory block listeners are notified of the removals. * Has no effect on memory blocks that are not currently registered. - * + * * @param memoryBlocks memory blocks to remove */ public void removeMemoryBlocks(IMemoryBlock[] memoryBlocks); - + /** * Registers the given listener for memory block addition and * removal notification. Has no effect if an identical listener * is already registered. - * + * * @param listener the listener to add */ public void addListener(IMemoryBlockListener listener); - + /** * Unregisters the given listener for memory block addition and * removal notification. Has no effect if an identical listener * is not already registered. - * + * * @param listener the listener to remove */ public void removeListener(IMemoryBlockListener listener); - + /** * Returns all registered memory blocks. - * + * * @return all registered memory blocks */ public IMemoryBlock[] getMemoryBlocks(); - + /** * Returns all registered memory blocks associated with the * given debug target. That is, all registered memory blocks * whose <code>getDebugTarget()</code> method returns the * specified debug target. - * + * * @param debugTarget target for which memory blocks have been requested * @return all registered memory blocks associated with the given debug * target */ public IMemoryBlock[] getMemoryBlocks(IDebugTarget debugTarget); - + /** * Returns all registered memory blocks that originated from the * given memory retrieval source. - * + * * @param source source for which memory blocks have been requested * @return all registered memory blocks that originated from the * given memory retrieval source diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IRequest.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IRequest.java index 851a4c80b..07a4952a0 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IRequest.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IRequest.java @@ -25,7 +25,7 @@ import org.eclipse.core.runtime.IStatus; * Clients are expected to poll a request (using <code>isCanceled</code>) * periodically and abort at their earliest convenience calling <code>done()</code>. * A request can be canceled by the originator of the request or a client - * fulfilling a request. + * fulfilling a request. * </p> * <p> * Clients that invoke request handlers may implement this interface. @@ -40,19 +40,19 @@ public interface IRequest { * indicates why the request failed. A <code>null</code> status is considered * to be successful. Only clients fulfilling a request should call this * method. Clients making a request are not intended to call this method. - * + * * @param status request status or <code>null</code> */ public void setStatus(IStatus status); - + /** * Returns the status of this request, or <code>null</code>. - * + * * @return request status - <code>null</code> is equivalent * to an OK status */ public IStatus getStatus(); - + /** * Indicates this request is complete. Clients must call this method * whether the request succeeds, fails, or is cancelled to indicate that @@ -60,7 +60,7 @@ public interface IRequest { * method. Clients making a request are not intended to call this method. */ public void done(); - + /** * Cancels this request. A request may be canceled by the originator of request * or a client fulfilling a request. Optionally a canceled status may be set on @@ -68,17 +68,17 @@ public interface IRequest { * <code>done()</code> to indicate the request is complete. */ public void cancel(); - + /** * Returns whether this request has been canceled. * <p> * Clients fulfilling a request are expected to poll a request (using <code>isCanceled</code>) * periodically and abort at their earliest convenience calling <code>done()</code>. * A request can be canceled by the originator of the request or a processor fulfilling a - * request. + * request. * </p> * @return whether this request has been canceled */ public boolean isCanceled(); - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IStatusHandler.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IStatusHandler.java index 571b06408..3306fdf62 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IStatusHandler.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IStatusHandler.java @@ -4,13 +4,13 @@ * 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 *******************************************************************************/ package org.eclipse.debug.core; - + import org.eclipse.core.runtime.CoreException; import org.eclipse.core.runtime.IStatus; @@ -35,7 +35,7 @@ import org.eclipse.core.runtime.IStatus; * Following is an example definition of a status handler extension. * <pre> * <extension point="org.eclipse.debug.core.statusHandlers"> - * <statusHandler + * <statusHandler * id="com.example.ExampleIdentifier" * class="com.example.ExampleStatusHandler" * plugin="com.example.ExamplePluginId" @@ -67,7 +67,7 @@ public interface IStatusHandler { /** * Notifies this status handler that the given status has been * generated by the specified source object and requires resolution. - * + * * @param status the status to handle * @param source the object delegating to this status handler * the given status diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/IStreamListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/IStreamListener.java index a074c89f8..a6c82b7fc 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/IStreamListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/IStreamListener.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IDebugCommandHandler.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IDebugCommandHandler.java index fae4ef9af..c28f4733f 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IDebugCommandHandler.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IDebugCommandHandler.java @@ -21,7 +21,7 @@ package org.eclipse.debug.core.commands; * delegates to the active context's {@link ITerminateHandler} implementation to update * its enabled state and execute the command. Debug model elements may implement supported * command handler interfaces directly or provide them as adapters. The debug platform - * provides implementations of handlers for standard debug models. + * provides implementations of handlers for standard debug models. * </p> * @see org.eclipse.core.runtime.IAdaptable * @see IDisconnectHandler @@ -36,7 +36,7 @@ package org.eclipse.debug.core.commands; * @since 3.3 */ public interface IDebugCommandHandler { - + /** * Determines whether this handler can execute on the elements specified * in the given request by reporting enabled state to the request. @@ -56,7 +56,7 @@ public interface IDebugCommandHandler { * @param request specifies elements to operate on and collects enabled state */ public void canExecute(IEnabledStateRequest request); - + /** * Executes this command on the elements specified in the given request * reporting status to the given request and returns whether this handler should @@ -64,7 +64,7 @@ public interface IDebugCommandHandler { * <p> * Implementations must be non-blocking and may respond asynchronously to the * given request. Errors can reported by setting an appropriate status - * on the given request. A request can be canceled by this handler or the caller. + * on the given request. A request can be canceled by this handler or the caller. * A <code>null</code> status is equivalent to an OK status. When a request is * complete, has encountered an error, or canceled, implementations must call * <code>done()</code> on the given collector. diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IDebugCommandRequest.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IDebugCommandRequest.java index b72100554..c1f30cf17 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IDebugCommandRequest.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IDebugCommandRequest.java @@ -13,7 +13,7 @@ package org.eclipse.debug.core.commands; import org.eclipse.debug.core.IRequest; /** - * A request to execute a command on specific elements. A debug command request is + * A request to execute a command on specific elements. A debug command request is * passed to a {@link IDebugCommandHandler} when a command is invoked. * <p> * Clients that invoke command handlers may implement this interface. @@ -24,7 +24,7 @@ public interface IDebugCommandRequest extends IRequest { /** * Returns the elements to execute a command on. - * + * * @return elements to execute a command on */ public Object[] getElements(); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IEnabledStateRequest.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IEnabledStateRequest.java index ee3e5b50f..428323b86 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IEnabledStateRequest.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IEnabledStateRequest.java @@ -25,7 +25,7 @@ public interface IEnabledStateRequest extends IDebugCommandRequest { /** * Sets the enabled state of a command handler. - * + * * @param result whether enabled */ public void setEnabled(boolean result); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IRestartHandler.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IRestartHandler.java index 0969d70b3..69097a7c4 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IRestartHandler.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IRestartHandler.java @@ -4,22 +4,22 @@ * 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: * Wind River Systems - initial API and implementation *******************************************************************************/ package org.eclipse.debug.core.commands; /** - * A restart command allows the debugger to quickly restart the current debug - * session without terminating and re-launching. + * A restart command allows the debugger to quickly restart the current debug + * session without terminating and re-launching. * <p> * Clients may implement this interface. The debug platform provides a - * restart action that delegates to this handler interface. Platform does not + * restart action that delegates to this handler interface. Platform does not * provide a default implementation of this handler, so to enable this action * the debugger implementation must provide one. * </p> - * + * * @since 3.6 */ public interface IRestartHandler extends IDebugCommandHandler { diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IStepFiltersHandler.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IStepFiltersHandler.java index 5d0b7391d..eb9a32b42 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IStepFiltersHandler.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/commands/IStepFiltersHandler.java @@ -16,7 +16,7 @@ import org.eclipse.debug.core.DebugPlugin; * A step filters handler typically toggles the use of step filters * in a debug session based on the user preference setting. To determine if step filters * should be enabled use the method <code>isUseStepFilters()</code> in - * {@link DebugPlugin}. + * {@link DebugPlugin}. * <p> * Clients may implement this interface. The debug platform provides a * toggle step filters action that delegates to this handler interface. As well, the diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugElement.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugElement.java index a6defd6c5..2401a8bcd 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugElement.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugElement.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -30,7 +30,7 @@ import org.eclipse.debug.core.ILaunch; * Debug elements are language independent. However, language specific * features can be made available via the adapter mechanism provided by * <code>IAdaptable</code>, or by extending the debug element interfaces. - * A debug model is responsible for declaring any special adapters + * A debug model is responsible for declaring any special adapters * its debug elements implement. * </p> * <p> @@ -38,7 +38,7 @@ import org.eclipse.debug.core.ILaunch; * </p> */ public interface IDebugElement extends IAdaptable { - + /** * Returns the unique identifier of the plug-in * this debug element originated from. @@ -48,13 +48,13 @@ public interface IDebugElement extends IAdaptable { public String getModelIdentifier(); /** * Returns the debug target this element is contained in. - * + * * @return the debug target this element is contained in */ public IDebugTarget getDebugTarget(); /** * Returns the launch this element is contained in. - * + * * @return the launch this element is contained in */ public ILaunch getLaunch(); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugModelProvider.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugModelProvider.java index 49fd1777a..92703d4a3 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugModelProvider.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugModelProvider.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -12,24 +12,24 @@ package org.eclipse.debug.core.model; /** * A debug model provider provides debug model identifiers. - * This interface is used as an adapter to determine what - * debug models are associated with an adaptable object. + * This interface is used as an adapter to determine what + * debug models are associated with an adaptable object. * Generally, when debugging one language, only one debug * model is associated with a debug element. However, * a debug model that provides cross language debugging - * may represent several debug models. + * may represent several debug models. * <p> * Clients are intended to implement this interface. * </p> * @since 3.0 */ public interface IDebugModelProvider { - + /** * Returns a collection of debug model identifiers. - * + * * @return a collection of debug model identifiers */ public String[] getModelIdentifiers(); - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugTarget.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugTarget.java index dee67fb7c..040586642 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugTarget.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDebugTarget.java @@ -42,7 +42,7 @@ import org.eclipse.debug.core.IBreakpointListener; public interface IDebugTarget extends IDebugElement, ITerminate, ISuspendResume, IBreakpointListener, IDisconnect, IMemoryBlockRetrieval { /** * Returns the system process associated with this debug target. - * + * * @return the system process associated with this debug target */ public IProcess getProcess(); @@ -50,7 +50,7 @@ public interface IDebugTarget extends IDebugElement, ITerminate, ISuspendResume, * Returns the threads contained in this debug target. An * empty collection is returned if this debug target contains * no threads. - * + * * @return a collection of threads * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -59,10 +59,10 @@ public interface IDebugTarget extends IDebugElement, ITerminate, ISuspendResume, * @since 2.0 */ public IThread[] getThreads() throws DebugException; - + /** * Returns whether this debug target currently contains any threads. - * + * * @return whether this debug target currently contains any threads * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -71,7 +71,7 @@ public interface IDebugTarget extends IDebugElement, ITerminate, ISuspendResume, * @since 2.0 */ public boolean hasThreads() throws DebugException; - + /** * Returns the name of this debug target. Name format is debug model * specific, and should be specified by a debug model. @@ -83,10 +83,10 @@ public interface IDebugTarget extends IDebugElement, ITerminate, ISuspendResume, * the failure.</li></ul> */ public String getName() throws DebugException; - + /** - * Returns whether this target can install the given breakpoint. - * + * Returns whether this target can install the given breakpoint. + * * @param breakpoint breakpoint to consider * @return whether this target can install the given breakpoint */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDisconnect.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDisconnect.java index c0cf267d5..aa3c6975d 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDisconnect.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDisconnect.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -24,7 +24,7 @@ import org.eclipse.debug.core.DebugException; public interface IDisconnect { /** * Returns whether this element can currently disconnect. - * + * * @return whether this element can currently disconnect */ public boolean canDisconnect(); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDropToFrame.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDropToFrame.java index 79229afd4..2fed49938 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDropToFrame.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IDropToFrame.java @@ -16,7 +16,7 @@ import org.eclipse.debug.core.DebugException; * Provides the ability to drop to frame. Drop to frame * generally means popping a selected stack frame (and all frames above it) from * the execution stack and then stepping back into the frame. - * + * * @since 3.1 */ public interface IDropToFrame { @@ -26,14 +26,14 @@ public interface IDropToFrame { * @return whether this element can currently perform a drop to frame */ public boolean canDropToFrame(); - + /** * Performs a drop to frame on this element. Implementations must generate * events such that debug clients can update appropriately, such as corresponding * <code>RESUME</code> and <code>SUSPEND</code> events, or a single <code>CHANGE</code> * event when the drop is complete. Implementations should implement drop to frame - * in a non-blocking fashion. - * + * in a non-blocking fashion. + * * @throws DebugException on failure. Reasons include:<ul> * <li>TARGET_REQUEST_FAILED - The request failed in the target</li> * <li>NOT_SUPPORTED - The capability is not supported by the target</li> diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IErrorReportingExpression.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IErrorReportingExpression.java index 3ba24d400..9d715c733 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IErrorReportingExpression.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IErrorReportingExpression.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -13,7 +13,7 @@ package org.eclipse.debug.core.model; /** * An expression that can report errors which occurred during the * expression's evaluation. - * + * * @since 3.0 */ public interface IErrorReportingExpression extends IExpression { @@ -21,7 +21,7 @@ public interface IErrorReportingExpression extends IExpression { * Returns whether this expression has errors to report. An expression * can have errors if errors were generated the last time its value was * computed - * + * * @return whether this expression's result has errors */ public boolean hasErrors(); @@ -29,7 +29,7 @@ public interface IErrorReportingExpression extends IExpression { * Returns this expression's error messages, if any. An expression can * have errors if errors were generated the last time its value was * computed. - * + * * @return this expression's error messages */ public String[] getErrorMessages(); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IFlushableStreamMonitor.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IFlushableStreamMonitor.java index 463faa3ff..ef4c4e14d 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IFlushableStreamMonitor.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IFlushableStreamMonitor.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -26,23 +26,23 @@ public interface IFlushableStreamMonitor extends IStreamMonitor { * Empties the contents of this stream monitor's underlying buffer. */ public void flushContents(); - + /** * Sets whether the contents of this monitor's underlying stream should be * buffered. When <code>false</code>, contents appended to this stream monitor * are not stored in a buffer, and are thus not available from * <code>getContents()</code>. Registered listeners are notified of appended * text, and must buffer the contents if desired. - * + * * @param buffer whether the contents of this monitor's underlying stream * should be buffered */ public void setBuffered(boolean buffer); - + /** * Returns whether the contents of this monitor's underlying stream is * buffered. - * + * * @return whether the contents of this monitor's underlying stream is * buffered */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IIndexedValue.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IIndexedValue.java index 0b66289af..106f4839c 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IIndexedValue.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IIndexedValue.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -27,23 +27,23 @@ import org.eclipse.debug.core.DebugException; * @since 3.0 */ public interface IIndexedValue extends IValue { - + /** * Returns the variable at the given offset in this collection. * The offset is zero based. - * @param offset zero based offset into this collection + * @param offset zero based offset into this collection * @return returns the variable in this collection at the given * offset * @throws DebugException if unable to retrieve the variable at the * given offset */ public IVariable getVariable(int offset) throws DebugException; - + /** * Returns a subset of the elements in this collection of variables as * specified by the given offset and length. - * - * @param offset beginning offset of the subset of elements to return + * + * @param offset beginning offset of the subset of elements to return * @param length the number of elements to return * @return a subset of the elements in this collection of variables as * specified by the given offset and length @@ -53,18 +53,18 @@ public interface IIndexedValue extends IValue { /** * Returns the number of entries in this indexed collection. - * + * * @return the number of entries in this indexed collection * @throws DebugException if unable to determine the number * of entries in this collection */ public int getSize() throws DebugException; - + /** * Returns the index of the first variable contained in this value. * Generally, indexed values are zero based, but this allows for * an arbitrary base offset. - * + * * @return the index of the first variable contained in this value */ public int getInitialOffset(); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILaunchConfigurationDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILaunchConfigurationDelegate.java index 7484f8d19..376fbe61d 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILaunchConfigurationDelegate.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILaunchConfigurationDelegate.java @@ -29,26 +29,26 @@ import org.eclipse.debug.core.ILaunchConfiguration; * @since 2.0 */ public interface ILaunchConfigurationDelegate { - + /** * Launches the given configuration in the specified mode, contributing * debug targets and/or processes to the given launch object. The * launch object has already been registered with the launch manager. - * + * * @param configuration the configuration to launch * @param mode the mode in which to launch, one of the mode constants * defined by <code>ILaunchManager</code> - * <code>RUN_MODE</code> or <code>DEBUG_MODE</code>. - * @param monitor progress monitor, or <code>null</code> progress monitor, or <code>null</code>. A cancelable progress - * monitor is provided by the Job framework. It should be noted that the setCanceled(boolean) method should - * never be called on the provided monitor or the monitor passed to any delegates from this method; due to a - * limitation in the progress monitor framework using the setCanceled method can cause entire workspace batch - * jobs to be canceled, as the canceled flag is propagated up the top-level parent monitor. - * The provided monitor is not guaranteed to have been started. + * @param monitor progress monitor, or <code>null</code> progress monitor, or <code>null</code>. A cancelable progress + * monitor is provided by the Job framework. It should be noted that the setCanceled(boolean) method should + * never be called on the provided monitor or the monitor passed to any delegates from this method; due to a + * limitation in the progress monitor framework using the setCanceled method can cause entire workspace batch + * jobs to be canceled, as the canceled flag is propagated up the top-level parent monitor. + * The provided monitor is not guaranteed to have been started. * @param launch the launch object to contribute processes and debug * targets to - * @exception CoreException if launching fails + * @exception CoreException if launching fails */ public void launch(ILaunchConfiguration configuration, String mode, ILaunch launch, IProgressMonitor monitor) throws CoreException; - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILaunchConfigurationDelegate2.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILaunchConfigurationDelegate2.java index 422124f0a..67c9df8af 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILaunchConfigurationDelegate2.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILaunchConfigurationDelegate2.java @@ -27,21 +27,21 @@ import org.eclipse.debug.core.ILaunchConfiguration; * @since 3.0 */ public interface ILaunchConfigurationDelegate2 extends ILaunchConfigurationDelegate { - + /** * Returns a launch object to use when launching the given launch * configuration in the given mode, or <code>null</code> if a new default * launch object should be created by the debug platform. If a launch object * is returned, its launch mode must match that of the mode specified in * this method call. - * + * * @param configuration the configuration being launched * @param mode the mode the configuration is being launched in * @return a launch object or <code>null</code> * @throws CoreException if unable to launch */ public ILaunch getLaunch(ILaunchConfiguration configuration, String mode) throws CoreException; - + /** * Optionally performs any required building before launching the given * configuration in the specified mode, and returns whether the debug platform @@ -51,54 +51,54 @@ public interface ILaunchConfigurationDelegate2 extends ILaunchConfigurationDeleg * be performed on the workspace before launching. * <p> * This method is only called if the launch is invoked with flag indicating - * building should take place before the launch. This is done via the + * building should take place before the launch. This is done via the * method * <code>ILaunchConfiguration.launch(String mode, IProgressMonitor monitor, boolean build)</code>. - * </p> + * </p> * @param configuration the configuration being launched * @param mode the mode the configuration is being launched in * @param monitor progress monitor, or <code>null</code>. A cancelable progress monitor is provided by the Job * framework. It should be noted that the setCanceled(boolean) method should never be called on the provided - * monitor or the monitor passed to any delegates from this method; due to a limitation in the progress monitor - * framework using the setCanceled method can cause entire workspace batch jobs to be canceled, as the canceled flag - * is propagated up the top-level parent monitor. The provided monitor is not guaranteed to have been started. + * monitor or the monitor passed to any delegates from this method; due to a limitation in the progress monitor + * framework using the setCanceled method can cause entire workspace batch jobs to be canceled, as the canceled flag + * is propagated up the top-level parent monitor. The provided monitor is not guaranteed to have been started. * @return whether the debug platform should perform an incremental workspace * build before the launch * @throws CoreException if an exception occurs while building */ public boolean buildForLaunch(ILaunchConfiguration configuration, String mode, IProgressMonitor monitor) throws CoreException; - + /** * Returns whether a launch should proceed. This method is called after * <code>preLaunchCheck()</code> and <code>buildForLaunch()</code> providing * a final chance for this launch delegate to abort a launch if required. * For example, a delegate could cancel a launch if it discovered compilation * errors that would prevent the launch from succeeding. - * + * * @param configuration the configuration being launched * @param mode launch mode * @param monitor progress monitor, or <code>null</code>. A cancelable progress monitor is provided by the Job * framework. It should be noted that the setCanceled(boolean) method should never be called on the provided - * monitor or the monitor passed to any delegates from this method; due to a limitation in the progress monitor - * framework using the setCanceled method can cause entire workspace batch jobs to be canceled, as the canceled flag - * is propagated up the top-level parent monitor. The provided monitor is not guaranteed to have been started. + * monitor or the monitor passed to any delegates from this method; due to a limitation in the progress monitor + * framework using the setCanceled method can cause entire workspace batch jobs to be canceled, as the canceled flag + * is propagated up the top-level parent monitor. The provided monitor is not guaranteed to have been started. * @return whether the launch should proceed * @throws CoreException if an exception occurs during final checks */ public boolean finalLaunchCheck(ILaunchConfiguration configuration, String mode, IProgressMonitor monitor) throws CoreException; - + /** * Returns whether a launch should proceed. This method is called first * in the launch sequence providing an opportunity for this launch delegate * to abort the launch. - * + * * @param configuration configuration being launched * @param mode launch mode * @param monitor progress monitor, or <code>null</code>. A cancelable progress monitor is provided by the Job * framework. It should be noted that the setCanceled(boolean) method should never be called on the provided - * monitor or the monitor passed to any delegates from this method; due to a limitation in the progress monitor - * framework using the setCanceled method can cause entire workspace batch jobs to be canceled, as the canceled flag - * is propagated up the top-level parent monitor. The provided monitor is not guaranteed to have been started. + * monitor or the monitor passed to any delegates from this method; due to a limitation in the progress monitor + * framework using the setCanceled method can cause entire workspace batch jobs to be canceled, as the canceled flag + * is propagated up the top-level parent monitor. The provided monitor is not guaranteed to have been started. * @return whether the launch should proceed * @throws CoreException if an exception occurs while performing pre-launch checks */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILineBreakpoint.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILineBreakpoint.java index 9b7b4cf0c..258056ce9 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILineBreakpoint.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILineBreakpoint.java @@ -4,13 +4,13 @@ * 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 *******************************************************************************/ package org.eclipse.debug.core.model; - + import org.eclipse.core.runtime.CoreException; /** diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILogicalStructureTypeDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILogicalStructureTypeDelegate.java index 50865a79e..73654cdeb 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILogicalStructureTypeDelegate.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILogicalStructureTypeDelegate.java @@ -24,20 +24,20 @@ import org.eclipse.core.runtime.CoreException; * @see org.eclipse.debug.core.ILogicalStructureType */ public interface ILogicalStructureTypeDelegate { - + /** - * Returns whether this structure type can provide a logical structure for + * Returns whether this structure type can provide a logical structure for * the given value. - * + * * @param value value for which a logical structure is being requested - * @return whether this structure type can provide a logical structure for + * @return whether this structure type can provide a logical structure for * the given value */ public boolean providesLogicalStructure(IValue value); - + /** * Returns a value representing a logical structure of the given value. - * + * * @param value value for which a logical structure is being requested * @return value representing logical structure * @throws CoreException if an exception occurs generating a logical diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILogicalStructureTypeDelegate2.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILogicalStructureTypeDelegate2.java index ff5f4e8b8..004453d0b 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILogicalStructureTypeDelegate2.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILogicalStructureTypeDelegate2.java @@ -29,14 +29,14 @@ package org.eclipse.debug.core.model; * @see org.eclipse.debug.core.ILogicalStructureType */ public interface ILogicalStructureTypeDelegate2 { - + /** * Returns a simple description of the logical structure provided by this * structure type delegate, for the given value. * Cannot return <code>null</code>. This method is only called if this * logical structure type delegate returns <code>true</code> for * <code>providesLogicalStructure(IValue)</code>. - * + * * @param value a value a description is requested for * @return a simple description of the logical structure provided by this * structure type delegate, for the given value diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlock.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlock.java index 7740c8adc..933b1fa89 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlock.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlock.java @@ -12,7 +12,7 @@ package org.eclipse.debug.core.model; import org.eclipse.debug.core.DebugException; - + /** * A contiguous segment of memory in an execution context. * A memory block is represented by a starting memory address @@ -25,25 +25,25 @@ import org.eclipse.debug.core.DebugException; * @since 2.0 */ public interface IMemoryBlock extends IDebugElement { - + /** * Returns the start address of this memory block. - * + * * @return the start address of this memory block */ public long getStartAddress(); - + /** * Returns the length of this memory block in bytes. - * + * * @return the length of this memory block in bytes - */ + */ public long getLength(); - + /** * Returns the values of the bytes currently contained * in this this memory block. - * + * * @return the values of the bytes currently contained * in this this memory block * @exception DebugException if this method fails. Reasons include: @@ -51,21 +51,21 @@ public interface IMemoryBlock extends IDebugElement { * status code contains the underlying exception responsible for * the failure.</li> * </ul> - */ + */ public byte[] getBytes() throws DebugException; - + /** * Returns whether this memory block supports value modification - * + * * @return whether this memory block supports value modification */ public boolean supportsValueModification(); - + /** * Sets the value of the bytes in this memory block at the specified * offset within this memory block to the specified bytes. * The offset is zero based. - * + * * @param offset the offset at which to set the new values * @param bytes the new values * @exception DebugException if this method fails. Reasons include: @@ -79,6 +79,6 @@ public interface IMemoryBlock extends IDebugElement { * </ul> */ public void setValue(long offset, byte[] bytes) throws DebugException; - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockExtension.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockExtension.java index cb4134807..5d972dff0 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockExtension.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockExtension.java @@ -17,7 +17,7 @@ import org.eclipse.debug.core.DebugException; /** * Extensions to {@link org.eclipse.debug.core.model.IMemoryBlock}. Allows * for bytes to be accessed in a larger address space, and for state information - * to be provided for each byte. + * to be provided for each byte. * <p> * Clients may optionally implement this interface when providing implementations of * {@link org.eclipse.debug.core.model.IMemoryBlock}. @@ -26,76 +26,76 @@ import org.eclipse.debug.core.DebugException; * @see org.eclipse.debug.core.model.MemoryByte */ public interface IMemoryBlockExtension extends IMemoryBlock { - + /** * Returns the expression used to create this memory block. An expression can * be used as name for a memory block and typically represents an expression * used to compute a base address for a memory block. - * + * * @return the expression used to create this memory block */ - public String getExpression(); - + public String getExpression(); + /** - * Returns the base address of this memory block as a big integer. The + * Returns the base address of this memory block as a big integer. The * address is in terms of addressable units. - * + * * @return the base address of this memory block * @throws DebugException if unable to retrieve the base address */ public BigInteger getBigBaseAddress() throws DebugException; - + /** - * Returns the hard start address of this memory block as a big integer, or + * Returns the hard start address of this memory block as a big integer, or * <code>null</code> if none. A <code>null</code> start address indicates that * memory may be retrieved at any address less than this memory block's base * address. - * + * * @return the hard start address of this memory block or <code>null</code> * @throws DebugException if unable to retrieve the start address of this memory block. */ public BigInteger getMemoryBlockStartAddress() throws DebugException; - + /** * Returns the hard end address of this memory block as a big integer, or * <code>null</code> if none. A <code>null</code> end address indicates that * memory may be retrieved from any positive offset relative to the base address - * of this memory block. - * + * of this memory block. + * * @return the hard end address of this memory block or <code>null</code> * @throws DebugException if unable to retrieve the end address of this memory block. */ public BigInteger getMemoryBlockEndAddress() throws DebugException; - + /** * Returns the length of this memory block, or -1 if unbounded. * Returns "end address - start address" for a memory block with a fixed * length (i.e. when both start and end address are known). * Returns -1 for an unbounded memory block (i.e. when start or end address is * <code>null</code>). - * + * * @return length of this memory block or -1 if unbounded * @throws DebugException if unable to retrieve the length of this memory block. */ public BigInteger getBigLength() throws DebugException; - + /** * Returns the address size of this memory block in number of bytes. The address * size indicates the number of bytes used to construct an address. - * + * * @return address size in number of bytes * @throws DebugException if unable to retrieve the address size */ public int getAddressSize() throws DebugException; - + /** * Returns whether the base address of this memory block can be modified. - * + * * @return whether the base address of this memory block can be modified * @throws DebugException is unable to determine if base address modification is supported */ public boolean supportBaseAddressModification() throws DebugException; - + /** * Returns whether this memory block manages the change state of its bytes. * <p> @@ -105,13 +105,13 @@ public interface IMemoryBlockExtension extends IMemoryBlock { * <code>getBytesFromOffset</code>. The changed state of a byte should * be updated each time a thread suspends in a memory block's target. * </p> - * @return whether this memory block manages the change state of its bytes + * @return whether this memory block manages the change state of its bytes */ public boolean supportsChangeManagement(); - + /** * Sets the base address of this memory block to the given address. - * + * * @param address new base address * @throws DebugException if unable to modify the base address, or modification * of the base address fails @@ -128,20 +128,20 @@ public interface IMemoryBlockExtension extends IMemoryBlock { * the <code>READABLE</code> bit turned off for each byte outside * the of the accessible range. An exception should not be thrown in this * case. - * </p> + * </p> * @param unitOffset zero based offset into this memory block at which to start * retrieving bytes in terms of addressable units. Client should retrieve * memory starting from "base address + offset". * @param addressableUnits the number of addressable units to retrieve * @return an array of bytes from this memory block based on the given offset - * and number of units. The size of the array returned must to be equal to + * and number of units. The size of the array returned must to be equal to * <code>units</code> * <code>getAddressableSize()</code>. * @throws DebugException if unable to retrieve the specified bytes due to * a failure communicating with the target * @see MemoryByte */ public MemoryByte[] getBytesFromOffset(BigInteger unitOffset, long addressableUnits) throws DebugException; - + /** * Returns bytes from this memory block based on the given address and the * addressable size of this memory block. @@ -155,21 +155,21 @@ public interface IMemoryBlockExtension extends IMemoryBlock { * </p> * @param address address at which to begin retrieving bytes in terms * of addressable units - * @param units is the number of addressable units of memory to retrieve + * @param units is the number of addressable units of memory to retrieve * @return an array of bytes from this memory block based on the given address - * and number of units. The size of the array returned must to be equal to + * and number of units. The size of the array returned must to be equal to * <code>units</code> * <code>getAddressableSize()</code>. * @throws DebugException if unable to retrieve the specified bytes due to - * a failure communicating with the target + * a failure communicating with the target * @see MemoryByte */ - public MemoryByte[] getBytesFromAddress(BigInteger address, long units) throws DebugException; + public MemoryByte[] getBytesFromAddress(BigInteger address, long units) throws DebugException; /** * Sets bytes in this memory block at the specified offset within this memory block to * the specified bytes. The offset is zero based. After successfully modifying the - * specified bytes, a debug event should be fired with a kind of <code>CHANGE</code>. - * + * specified bytes, a debug event should be fired with a kind of <code>CHANGE</code>. + * * @param offset the zero based offset at which to set the new value. Modify * the memory starting from base address + offset. * @param bytes replacement bytes @@ -200,42 +200,42 @@ public interface IMemoryBlockExtension extends IMemoryBlock { * @param client the client to connect */ public void connect(Object client); - + /** * Disconnects the given client from this memory block. Has no effect if * an identical client is not already connected. - * + * * @param client the client to disconnect */ public void disconnect(Object client); - + /** * Returns the possibly empty list of clients currently connected to this * memory block. - * + * * @return the possibly empty list of clients currently connected to this * memory block */ public Object[] getConnections(); - + /** * Dispose this memory block. Connected clients are disconnected. * @throws DebugException if the memory block cannot be disposed. */ public void dispose() throws DebugException; - + /** * Returns the origin of this memory block. - * + * * @return the origin of this memory block */ public IMemoryBlockRetrieval getMemoryBlockRetrieval(); - + /** * Returns this memory block's addressable size in number of bytes. The addressable size * of memory block indicates the minimum number of bytes that can be retrieved as * a single unit. - * + * * @return this memory block's addressable size * @throws DebugException if the addressable size cannot be obtained. */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockRetrieval.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockRetrieval.java index 925366297..78f16e775 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockRetrieval.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockRetrieval.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -12,28 +12,28 @@ package org.eclipse.debug.core.model; import org.eclipse.debug.core.DebugException; - + /** * Supports the retrieval of arbitrary blocks of memory. - * + * * @see IMemoryBlock * @since 2.0 */ public interface IMemoryBlockRetrieval { - + /** * Returns whether this debug target supports the retrieval * of memory blocks. - * + * * @return whether this debug target supports the retrieval * of memory blocks */ public boolean supportsStorageRetrieval(); - + /** * Returns a memory block that starts at the specified * memory address, with the specified length. - * + * * @param startAddress starting address * @param length length of the memory block in bytes * @return a memory block that starts at the specified diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockRetrievalExtension.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockRetrievalExtension.java index f6aea1b55..88eb0b910 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockRetrievalExtension.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IMemoryBlockRetrievalExtension.java @@ -17,20 +17,20 @@ import org.eclipse.debug.core.DebugException; /** * Extended capabilities for memory block retrieval. Supports the retrieval * of memory blocks based on an expression and context. - * + * * @since 3.1 */ public interface IMemoryBlockRetrievalExtension extends IMemoryBlockRetrieval { - + /** - * Retrieves and returns a memory block. - * + * Retrieves and returns a memory block. + * * @param expression expression to be evaluated to an address * @param context context for evaluating the expression. This is typically * a debug element. * @return a memory block based on the given expression and context * @throws DebugException if unable to retrieve the specified memory */ - + public IMemoryBlockExtension getExtendedMemoryBlock(String expression, Object context) throws DebugException; } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IPersistableSourceLocator.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IPersistableSourceLocator.java index 8433aa8d4..ae4ac9bb2 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IPersistableSourceLocator.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IPersistableSourceLocator.java @@ -24,7 +24,7 @@ import org.eclipse.debug.core.ILaunchConfiguration; * Following is an example definition of a source locator extension. * <pre> * <extension point="org.eclipse.debug.core.sourceLocators"> - * <sourceLocator + * <sourceLocator * id="com.example.ExampleIdentifier" * class="com.example.ExampleSourceLocator" * name="Example Source Locator"> @@ -44,34 +44,34 @@ import org.eclipse.debug.core.ILaunchConfiguration; * Clients may implement this interface. * </p> * @see org.eclipse.debug.core.ILaunch - * @see IStackFrame + * @see IStackFrame * @since 2.0 */ public interface IPersistableSourceLocator extends ISourceLocator { - + /** * Returns a memento that can be used to reconstruct * this source locator - * + * * @return a memento that can be used to reconstruct * this source locator * @exception CoreException if unable to construct a memento */ public String getMemento() throws CoreException; - + /** * Initializes this source locator based on the given * memento. - * + * * @param memento a memento to initialize this source locator - * @exception CoreException on failure to initialize + * @exception CoreException on failure to initialize */ public void initializeFromMemento(String memento) throws CoreException; - + /** * Initializes this source locator to perform default * source lookup for the given launch configuration. - * + * * @param configuration launch configuration this source locator * will be performing source lookup for * @exception CoreException on failure to initialize diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IProcess.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IProcess.java index 7ce2452b4..10b5924f8 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IProcess.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IProcess.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -25,20 +25,20 @@ import org.eclipse.debug.core.ILaunch; * <p> * Clients may implement this interface, however, the debug plug-in * provides an implementation of this interface for a - * <code>java.lang.Process</code>. + * <code>java.lang.Process</code>. * </p> * @see org.eclipse.debug.core.DebugPlugin#newProcess(ILaunch, Process, String) */ public interface IProcess extends IAdaptable, ITerminate { - + /** * Attribute key for a common, optional, process property. The value of this * attribute is the command line a process was launched with. - * + * * @since 2.1 */ public final static String ATTR_CMDLINE= DebugPlugin.getUniqueIdentifier() + ".ATTR_CMDLINE"; //$NON-NLS-1$ - + /** * Attribute key for a common, optional, process property. The value of this * attribute is an identifier for the type of this process. Process types @@ -47,17 +47,17 @@ public interface IProcess extends IAdaptable, ITerminate { * * @since 2.1 */ - public final static String ATTR_PROCESS_TYPE = DebugPlugin.getUniqueIdentifier() + ".ATTR_PROCESS_TYPE"; //$NON-NLS-1$ + public final static String ATTR_PROCESS_TYPE = DebugPlugin.getUniqueIdentifier() + ".ATTR_PROCESS_TYPE"; //$NON-NLS-1$ /** * Attribute key for a common, optional, process property. The value of this * attribute specifies an alternate dynamic label for a process, displayed by * the console. - * + * * @since 3.0 */ public final static String ATTR_PROCESS_LABEL = DebugPlugin.getUniqueIdentifier() + ".ATTR_PROCESS_LABEL"; //$NON-NLS-1$ - + /** * Returns a human-readable label for this process. * @@ -71,13 +71,13 @@ public interface IProcess extends IAdaptable, ITerminate { */ public ILaunch getLaunch(); /** - * Returns a proxy to the standard input, output, and error streams + * Returns a proxy to the standard input, output, and error streams * for this process, or <code>null</code> if not supported. * * @return a streams proxy, or <code>null</code> if not supported */ public IStreamsProxy getStreamsProxy(); - + /** * Sets the value of a client defined attribute. * @@ -85,7 +85,7 @@ public interface IProcess extends IAdaptable, ITerminate { * @param value the attribute value */ public void setAttribute(String key, String value); - + /** * Returns the value of a client defined attribute. * @@ -93,11 +93,11 @@ public interface IProcess extends IAdaptable, ITerminate { * @return value the String attribute value, or <code>null</code> if undefined */ public String getAttribute(String key); - + /** * Returns the exit value of this process. Conventionally, 0 indicates * normal termination. - * + * * @return the exit value of this process * @exception DebugException if this process has not yet terminated */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IRegister.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IRegister.java index d3bd7390c..35116f5ad 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IRegister.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IRegister.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -12,7 +12,7 @@ package org.eclipse.debug.core.model; import org.eclipse.debug.core.DebugException; - + /** * A register is a special kind of variable that is contained * in a register group. Each register has a name and a value. @@ -23,17 +23,17 @@ import org.eclipse.debug.core.DebugException; * @since 2.0 */ public interface IRegister extends IVariable { - + /** * Returns the register group this register is contained in. - * + * * @return the register group this register is contained in * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's * status code contains the underlying exception responsible for * the failure.</li> */ - public IRegisterGroup getRegisterGroup() throws DebugException; + public IRegisterGroup getRegisterGroup() throws DebugException; } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IRegisterGroup.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IRegisterGroup.java index 528df358f..413a41356 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IRegisterGroup.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IRegisterGroup.java @@ -4,32 +4,32 @@ * 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 *******************************************************************************/ package org.eclipse.debug.core.model; - + import org.eclipse.debug.core.DebugException; - + /** * A register group is a group of registers that are * assigned to a stack frame. Some debug architectures * provide access to registers, and registers are often * grouped logically. For example, a floating point - * register group. + * register group. * <p> * Clients may implement this interface. * </p> * @since 2.0 */ public interface IRegisterGroup extends IDebugElement { - + /** * Returns the name of this register group. - * + * * @return this register group's name * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -37,10 +37,10 @@ public interface IRegisterGroup extends IDebugElement { * the failure.</li> */ public String getName() throws DebugException; - + /** * Returns the registers in this register group. - * + * * @return the registers in this register group * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -48,17 +48,17 @@ public interface IRegisterGroup extends IDebugElement { * the failure.</li> */ public IRegister[] getRegisters() throws DebugException; - + /** * Returns whether this register group currently contains any registers. - * + * * @return whether this register group currently contains any registers * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's * status code contains the underlying exception responsible for * the failure.</li> */ - public boolean hasRegisters() throws DebugException; + public boolean hasRegisters() throws DebugException; } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ISourceLocator.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ISourceLocator.java index e78a7f893..5c62e963e 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ISourceLocator.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ISourceLocator.java @@ -38,11 +38,11 @@ import org.eclipse.debug.core.model.IStackFrame; * Clients may implement this interface. * </p> * @see org.eclipse.debug.core.ILaunch - * @see org.eclipse.debug.core.model.IStackFrame + * @see org.eclipse.debug.core.model.IStackFrame * @see org.eclipse.debug.core.model.IPersistableSourceLocator */ public interface ISourceLocator { - + /** * Returns a source element that corresponds to the given stack frame, or * <code>null</code> if a source element could not be located. The object returned @@ -58,7 +58,7 @@ public interface ISourceLocator { * </p> * * @param stackFrame the stack frame for which to locate source - * @return an object representing a source element. + * @return an object representing a source element. */ public Object getSourceElement(IStackFrame stackFrame); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStackFrame.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStackFrame.java index 72ee242e1..985fd5418 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStackFrame.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStackFrame.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -35,7 +35,7 @@ import org.eclipse.debug.core.DebugException; * across iterative suspensions may display more desirable behavior in * some clients. For example, if stack frames are preserved * while stepping, a UI client would be able to update the UI incrementally, - * rather than collapse and redraw the entire list. + * rather than collapse and redraw the entire list. * </p> * <p> * Clients may implement this interface. @@ -47,7 +47,7 @@ import org.eclipse.debug.core.DebugException; public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerminate { /** * Returns the thread this stack frame is contained in. - * + * * @return thread * @since 2.0 */ @@ -55,7 +55,7 @@ public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerm /** * Returns the visible variables in this stack frame. An empty * collection is returned if there are no visible variables. - * + * * @return collection of visible variables * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -65,10 +65,10 @@ public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerm * @since 2.0 */ public IVariable[] getVariables() throws DebugException; - + /** * Returns whether this stack frame currently contains any visible variables. - * + * * @return whether this stack frame currently contains any visible variables * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -78,14 +78,14 @@ public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerm * @since 2.0 */ public boolean hasVariables() throws DebugException; - + /** - * Returns the line number of the instruction pointer in + * Returns the line number of the instruction pointer in * this stack frame that corresponds to a line in an associated source * element, or <code>-1</code> if line number information * is unavailable. * - * @return line number of instruction pointer in this stack frame, or + * @return line number of instruction pointer in this stack frame, or * <code>-1</code> if line number information is unavailable * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -94,7 +94,7 @@ public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerm * </ul> */ public int getLineNumber() throws DebugException; - + /** * Returns the index of the first character in the associated source * element that corresponds to the current location of the instruction pointer @@ -115,7 +115,7 @@ public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerm * @since 2.0 */ public int getCharStart() throws DebugException; - + /** * Returns the index of the last character in the associated source * element that corresponds to the current location of the instruction pointer @@ -135,8 +135,8 @@ public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerm * </ul> * @since 2.0 */ - public int getCharEnd() throws DebugException; - + public int getCharEnd() throws DebugException; + /** * Returns the name of this stack frame. Name format is debug model * specific, and should be specified by a debug model. @@ -149,12 +149,12 @@ public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerm * </ul> */ public String getName() throws DebugException; - + /** * Returns the register groups assigned to this stack frame, * or an empty collection if no register groups are assigned * to this stack frame. - * + * * @return the register groups assigned to this stack frame * or an empty collection if no register groups are assigned * to this stack frame @@ -166,10 +166,10 @@ public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerm * @since 2.0 */ public IRegisterGroup[] getRegisterGroups() throws DebugException; - + /** * Returns whether this stack frame contains any register groups. - * + * * @return whether this stack frame contains any visible register groups * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -178,5 +178,5 @@ public interface IStackFrame extends IDebugElement, IStep, ISuspendResume, ITerm * </ul> * @since 2.0 */ - public boolean hasRegisterGroups() throws DebugException; + public boolean hasRegisterGroups() throws DebugException; } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStep.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStep.java index 009aaad14..0d2362d59 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStep.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStep.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStepFilters.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStepFilters.java index 1e11c956c..1c58584fd 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStepFilters.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStepFilters.java @@ -38,26 +38,26 @@ package org.eclipse.debug.core.model; * @since 3.0 */ public interface IStepFilters { - + /** * Returns whether this debug target supports step filters. * * @return whether this debug target supports step filters */ public boolean supportsStepFilters(); - + /** * Returns whether step filters are currently enabled in this * debug target. - * + * * @return whether step filters are currently enabled in this * debug target */ public boolean isStepFiltersEnabled(); - + /** * Sets whether step filters are enabled in this debug target. - * + * * @param enabled whether step filters are enabled in this debug target */ public void setStepFiltersEnabled(boolean enabled); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamMonitor.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamMonitor.java index fdabfb2d7..e6da88b72 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamMonitor.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamMonitor.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamsProxy.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamsProxy.java index 120e5e831..e5d382b4d 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamsProxy.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamsProxy.java @@ -4,13 +4,13 @@ * 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 *******************************************************************************/ package org.eclipse.debug.core.model; - + import java.io.IOException; /** @@ -49,7 +49,7 @@ public interface IStreamsProxy { * standard input stream of this proxy's process. * * @param input the text to be written - * @exception IOException when an error occurs writing to the + * @exception IOException when an error occurs writing to the * underlying <code>OutputStream</code>. * */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamsProxy2.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamsProxy2.java index d0294dbb9..f7954e2ff 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamsProxy2.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IStreamsProxy2.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -27,7 +27,7 @@ public interface IStreamsProxy2 extends IStreamsProxy { /** * Closes the output stream connected to the standard input stream * of this proxy's process. - * + * * @throws IOException if unable to close the stream */ public void closeInputStream() throws IOException; diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ISuspendResume.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ISuspendResume.java index 9ffe269e1..1e84d8d52 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ISuspendResume.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ISuspendResume.java @@ -4,13 +4,13 @@ * 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 *******************************************************************************/ package org.eclipse.debug.core.model; - + import org.eclipse.debug.core.DebugException; /** @@ -40,7 +40,7 @@ public interface ISuspendResume { */ public boolean isSuspended(); /** - * Causes this element to resume its execution, generating a <code>RESUME</code> event. + * Causes this element to resume its execution, generating a <code>RESUME</code> event. * Has no effect on an element that is not suspended. This call is non-blocking. * * @exception DebugException on failure. Reasons include:<ul> diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ITerminate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ITerminate.java index 0c376aa75..fbf6e8491 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ITerminate.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ITerminate.java @@ -4,13 +4,13 @@ * 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 *******************************************************************************/ package org.eclipse.debug.core.model; - + import org.eclipse.debug.core.DebugException; /** @@ -34,7 +34,7 @@ public interface ITerminate { */ public boolean isTerminated(); /** - * Causes this element to terminate, generating a <code>TERMINATE</code> event. + * Causes this element to terminate, generating a <code>TERMINATE</code> event. * Implementations may be blocking or non-blocking. * * @exception DebugException on failure. Reasons include:<ul> diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IThread.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IThread.java index 54f56679b..16766e85c 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IThread.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IThread.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -38,7 +38,7 @@ public interface IThread extends IDebugElement, ISuspendResume, IStep, ITerminat * empty collection is returned if this thread contains * no stack frames, or is not currently suspended. Stack frames * are returned in top down order. - * + * * @return a collection of stack frames * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the VM. The DebugException's @@ -48,11 +48,11 @@ public interface IThread extends IDebugElement, ISuspendResume, IStep, ITerminat * @since 2.0 */ public IStackFrame[] getStackFrames() throws DebugException; - + /** * Returns whether this thread currently contains any stack * frames. - * + * * @return whether this thread currently contains any stack frames * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -62,7 +62,7 @@ public interface IThread extends IDebugElement, ISuspendResume, IStep, ITerminat * @since 2.0 */ public boolean hasStackFrames() throws DebugException; - + /** * Returns the priority of this thread. The meaning of this * number is operating-system dependent. @@ -74,7 +74,7 @@ public interface IThread extends IDebugElement, ISuspendResume, IStep, ITerminat * the failure.</li> */ public int getPriority() throws DebugException; - /** + /** * Returns the top stack frame or <code>null</code> if there is * currently no top stack frame. * @@ -107,5 +107,5 @@ public interface IThread extends IDebugElement, ISuspendResume, IStep, ITerminat * * @return the collection of breakpoints that caused this thread to suspend */ - public IBreakpoint[] getBreakpoints(); + public IBreakpoint[] getBreakpoints(); } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IValue.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IValue.java index 89652fe42..3fdc5d987 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IValue.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IValue.java @@ -4,13 +4,13 @@ * 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 *******************************************************************************/ package org.eclipse.debug.core.model; - + import org.eclipse.debug.core.DebugException; /** @@ -38,11 +38,11 @@ import org.eclipse.debug.core.DebugException; public interface IValue extends IDebugElement { - + /** * Returns a description of the type of data this value contains * or references. - * + * * @return the name of this value's reference type * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the VM. The DebugException's @@ -50,7 +50,7 @@ public interface IValue extends IDebugElement { * the failure.</li> */ public String getReferenceTypeName() throws DebugException; - + /** * Returns this value as a <code>String</code>. * @@ -61,7 +61,7 @@ public interface IValue extends IDebugElement { * the failure.</li> */ public String getValueString() throws DebugException; - + /** * Returns whether this value is currently allocated. * <p> @@ -78,7 +78,7 @@ public interface IValue extends IDebugElement { /** * Returns the visible variables in this value. An empty * collection is returned if there are no visible variables. - * + * * @return an array of visible variables * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the VM. The DebugException's @@ -88,10 +88,10 @@ public interface IValue extends IDebugElement { * @since 2.0 */ public IVariable[] getVariables() throws DebugException; - + /** * Returns whether this value currently contains any visible variables. - * + * * @return whether this value currently contains any visible variables * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the debug target. The DebugException's @@ -100,5 +100,5 @@ public interface IValue extends IDebugElement { * </ul> * @since 2.0 */ - public boolean hasVariables() throws DebugException; + public boolean hasVariables() throws DebugException; } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IValueModification.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IValueModification.java index b4266017c..d67e7c0b5 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IValueModification.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IValueModification.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -34,7 +34,7 @@ public interface IValueModification { * </ul> */ public void setValue(String expression) throws DebugException; - + /** * Sets the value of this variable to the given value. * @@ -45,15 +45,15 @@ public interface IValueModification { * </ul> * @since 2.0 */ - public void setValue(IValue value) throws DebugException; - + public void setValue(IValue value) throws DebugException; + /** * Returns whether this variable supports value modification. * * @return whether this variable supports value modification */ public boolean supportsValueModification(); - + /** * Returns whether the given expression is valid to be used in * setting a new value for this variable. @@ -66,7 +66,7 @@ public interface IValueModification { * </ul> */ public boolean verifyValue(String expression) throws DebugException; - + /** * Returns whether the given value can be used as * a new value for this variable. diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IVariable.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IVariable.java index f199c0539..d9e98b9b1 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IVariable.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IVariable.java @@ -10,7 +10,7 @@ *******************************************************************************/ package org.eclipse.debug.core.model; - + import org.eclipse.debug.core.DebugException; /** @@ -42,7 +42,7 @@ import org.eclipse.debug.core.DebugException; public interface IVariable extends IDebugElement, IValueModification { /** * Returns the value of this variable. - * + * * @return this variable's value * @exception DebugException if this method fails. Reasons include: * <ul><li>Failure communicating with the VM. The DebugException's @@ -60,7 +60,7 @@ public interface IVariable extends IDebugElement, IValueModification { * status code contains the underlying exception responsible for * the failure.</li> */ - public String getName() throws DebugException; + public String getName() throws DebugException; /** * Returns a description of the type of data this variable is * declared to reference. Note that the declared type of a @@ -74,22 +74,22 @@ public interface IVariable extends IDebugElement, IValueModification { * the failure.</li> */ public String getReferenceTypeName() throws DebugException; - - /** - * Returns whether this variable's value has changed since the last suspend event. - * Implementations may choose whether the last suspend event is the last suspend - * event in this variable's debug target, or within the thread(s) in which this variable - * is visible. + + /** + * Returns whether this variable's value has changed since the last suspend event. + * Implementations may choose whether the last suspend event is the last suspend + * event in this variable's debug target, or within the thread(s) in which this variable + * is visible. * <p> * Implementations that choose not to implement this function should always * return <code>false</code>. * </p> - * - * @return whether this variable's value has changed since the last suspend event - * @exception DebugException if an exception occurs determining if this variable's - * value has changed since the last suspend event - */ - public boolean hasValueChanged() throws DebugException; + * + * @return whether this variable's value has changed since the last suspend event + * @exception DebugException if an exception occurs determining if this variable's + * value has changed since the last suspend event + */ + public boolean hasValueChanged() throws DebugException; + - } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpression.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpression.java index db4617353..fd5997861 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpression.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpression.java @@ -17,7 +17,7 @@ package org.eclipse.debug.core.model; * each time a debug target suspends, or when a user provides a context * for an evaluation by selecting a debug target or thread. An expression * updates its value when it is provided with a context in which it - * can perform an evaluation. + * can perform an evaluation. * <p> * An implementation is provided by the debug platform. Clients that support watch expressions * should contribute and implement a watch expression delegate. Watch @@ -30,13 +30,13 @@ package org.eclipse.debug.core.model; * @noextend This interface is not intended to be extended by clients. */ public interface IWatchExpression extends IErrorReportingExpression { - + /** * Updates this watch expression's value based on the current evaluation * context. This watch expression fires a debug change event when the * evaluation is complete. A watch expression can be asked to * evaluate even when it is disabled. Note that implementations should - * generally be asynchronous to avoid blocking the calling thread. + * generally be asynchronous to avoid blocking the calling thread. */ public void evaluate(); /** @@ -53,7 +53,7 @@ public interface IWatchExpression extends IErrorReportingExpression { * <li>a stack frame (<code>IStackFrame</code>)</li> * </ul> * </p> - * + * * @param context context in which to update this expression's value, or * <code>null</code> if none */ @@ -62,7 +62,7 @@ public interface IWatchExpression extends IErrorReportingExpression { * Sets this watch expression's snippet of code. This method * causes the new snippet to be evaluated immediately in * the expression's last context. - * + * * @param expressionText the snippet which will be evaluated */ public void setExpressionText(String expressionText); @@ -70,14 +70,14 @@ public interface IWatchExpression extends IErrorReportingExpression { * Returns whether the result of this watch expression is pending. * An expression is pending if an evaluation has been requested, but * the value has not yet been returned. - * + * * @return whether this expression's result is pending */ public boolean isPending(); /** * Returns whether this expression is enabled. An enabled expression will * update its value. A disabled expression will not. - * + * * @return whether this expression is enabled */ public boolean isEnabled(); @@ -85,7 +85,7 @@ public interface IWatchExpression extends IErrorReportingExpression { * Sets this expression's enabled state. This method * causes the new snippet to be evaluated immediately in * the expression's last context. - * + * * @param enabled whether this expression should be enabled */ public void setEnabled(boolean enabled); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionDelegate.java index ec662ecc1..0757ee95a 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionDelegate.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionDelegate.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -33,16 +33,16 @@ package org.eclipse.debug.core.model; * </p> * @see org.eclipse.debug.core.model.IWatchExpression * @see org.eclipse.debug.core.model.IWatchExpressionListener - * + * * @since 3.0 */ public interface IWatchExpressionDelegate { - + /** * Evaluates the given expression in the given context asynchronously and * notifies the given listener when the evaluation finishes. - * - * @param expression the expression to evaluate + * + * @param expression the expression to evaluate * @param context the context for the evaluation * @param listener the listener to notify when the evaluation completes */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionListener.java index 34007a9ec..2edb5697d 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionListener.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -14,7 +14,7 @@ package org.eclipse.debug.core.model; * A watch expression listener is notified when an * <code>org.eclipse.debug.core.model.IWatchExpressionDelegate</code> * completes an evaluation. - * + * * @see org.eclipse.debug.core.model.IWatchExpressionDelegate * @see org.eclipse.debug.core.model.IWatchExpressionResult * @since 3.0 @@ -23,7 +23,7 @@ public interface IWatchExpressionListener { /** * Notifies the listener that an evaluation has completed. - * + * * @param result the result of the evaluation */ public void watchEvaluationFinished(IWatchExpressionResult result); diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionResult.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionResult.java index 26bfd7728..cd57189ff 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionResult.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchExpressionResult.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -35,7 +35,7 @@ public interface IWatchExpressionResult { * <code>null</code> */ public IValue getValue(); - + /** * Returns whether the evaluation had any problems * or if an exception occurred while performing the @@ -46,7 +46,7 @@ public interface IWatchExpressionResult { * @see #getException() */ public boolean hasErrors(); - + /** * Returns an array of problem messages. Each message describes a problem that * occurred while compiling the snippet. @@ -54,14 +54,14 @@ public interface IWatchExpressionResult { * @return evaluation error messages, or an empty array if no errors occurred */ public String[] getErrorMessages(); - + /** * Returns the expression that was evaluated. * * @return The string expression. */ public String getExpressionText(); - + /** * Returns any exception that occurred while performing the evaluation * or <code>null</code> if an exception did not occur. diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchpoint.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchpoint.java index bb356fe9f..8a1a244a1 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchpoint.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/IWatchpoint.java @@ -4,20 +4,20 @@ * 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 *******************************************************************************/ package org.eclipse.debug.core.model; - + import org.eclipse.core.runtime.CoreException; /** * A breakpoint that suspends when an associated variable is * read or written. * <p> - * Clients may implement this interface. Clients are not required to + * Clients may implement this interface. Clients are not required to * implement this interface to implement watchpoints, but those that do inherit * default rendering of images for watchpoints from the debug platform's * default label provider and actions to toggle access and modification @@ -29,16 +29,16 @@ public interface IWatchpoint extends IBreakpoint { /** * Returns whether this watchpoint will suspend execution when its associated * variable is accessed (read). - * + * * @return whether this is an access watchpoint * @exception CoreException if unable to access the property * on this breakpoint's underlying marker - */ + */ public boolean isAccess() throws CoreException; /** * Sets whether this breakpoint will suspend execution when its associated * variable is accessed. - * + * * @param access whether to suspend on access * @exception CoreException if unable to set the property on this breakpoint's * underlying marker or if the capability is not supported @@ -47,16 +47,16 @@ public interface IWatchpoint extends IBreakpoint { /** * Returns whether this watchpoint will suspend execution when its associated * variable is written. - * + * * @return whether this is a modification watchpoint * @exception CoreException if unable to access the property * on this breakpoint's underlying marker - */ + */ public boolean isModification() throws CoreException; /** * Sets whether this breakpoint will suspend execution when its associated * variable is modified. - * + * * @param modification whether to suspend on modification * @exception CoreException if unable to set the property on * this breakpoint's underlying marker or if the capability is not supported @@ -65,7 +65,7 @@ public interface IWatchpoint extends IBreakpoint { /** * Returns whether this breakpoints supports the capability to suspend * when an associated variable is read. - * + * * @return whether this breakpoints supports the capability to suspend * when an associated variable is read */ @@ -73,10 +73,10 @@ public interface IWatchpoint extends IBreakpoint { /** * Returns whether this breakpoints supports the ability to suspend * when an associated variable is written. - * + * * @return whether this breakpoints supports the ability to suspend * when an associated variable is written - */ + */ public boolean supportsModification(); } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/MemoryByte.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/MemoryByte.java index 6498ec379..7622e8fc9 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/MemoryByte.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/MemoryByte.java @@ -16,60 +16,60 @@ package org.eclipse.debug.core.model; * attributes indicating if the byte is read-only, valid, or if its value has * changed. * <p> - * Clients may instantiate this class. Clients may subclass this class to + * Clients may instantiate this class. Clients may subclass this class to * add other attributes to a memory byte, as required. * </p> * @since 3.1 * @see org.eclipse.debug.core.model.IMemoryBlockExtension */ public class MemoryByte { - + /** * Bit mask used to indicate a byte is writable. */ public static final byte WRITABLE = 0x01; - + /** * Bit mask used to indicate a byte is readable. * A memory byte is readable when its value and attributes are retrievable. * Otherwise, a byte is considered non-readable. */ public static final byte READABLE = 0x02; - + /** * Bit mask used to indicate a byte has changed since the last * suspend event. - * + * * @see org.eclipse.debug.core.DebugEvent#SUSPEND */ public static final byte CHANGED = 0x04; - + /** * Bit mask used to indicate a memory byte has history to * determine if its value has changed. When a memory byte's * history is unknown, the change state has no meaning. */ public static final byte HISTORY_KNOWN = 0x08; - + /** * Bit mask used to indicate a this byte of memory * is big endian. If this byte of memory is little endian, * turn this bit mask to off. */ public static final byte BIG_ENDIAN = 0x10; - + /** * Bit mask used to indicate that the endianess of this byte * of memory is known. When a memory byte's endianess is - * unknown, the endianess of this byte has no meaning. + * unknown, the endianess of this byte has no meaning. */ public static final byte ENDIANESS_KNOWN = 0x20; - + /** * Value of this byte. */ protected byte value; - + /** * Attribute flags. * <p> @@ -78,7 +78,7 @@ public class MemoryByte { * </p> */ protected byte flags; - + /** * Constructs a readable, writable memory byte without a change history, * and a value of 0. The byte's endianess is known and is little endian @@ -87,33 +87,33 @@ public class MemoryByte { public MemoryByte() { this((byte)0, (byte)(WRITABLE | READABLE | ENDIANESS_KNOWN)); } - + /** * Constructs a readable, writable memory byte without a change history, * with the given value. The byte's endianess is known and is little endian - * by default. - * + * by default. + * * @param byteValue value of this memory byte - * + * */ public MemoryByte(byte byteValue) { this(byteValue, (byte)(WRITABLE | READABLE | ENDIANESS_KNOWN)); } - + /** * Constructs a memory byte with the given value and attributes. - * + * * @param byteValue value of this memory byte - * @param byteFlags attributes of the byte specified as a bit mask + * @param byteFlags attributes of the byte specified as a bit mask */ - public MemoryByte(byte byteValue, byte byteFlags) { + public MemoryByte(byte byteValue, byte byteFlags) { value = byteValue; flags = byteFlags; } /** * Returns this memory byte's attribute as a bit mask. - * + * * @return this memory byte's attribute as a bit mask */ public byte getFlags() { @@ -121,7 +121,7 @@ public class MemoryByte { } /** * Sets this memory byte's attributes based on the given bit mask. - * + * * @param flags bit mask of attributes */ public void setFlags(byte flags) { @@ -130,27 +130,27 @@ public class MemoryByte { /** * Returns the value of this memory byte. - * + * * @return the value of this memory byte */ public byte getValue() { return value; } - + /** * Sets the value of this memory byte. - * + * * @param value the new value of this memory byte */ public void setValue(byte value) { this.value = value; } - + /** * Sets whether this memory byte is readable. A memory byte * is considered readable when its value and attributes are * retrievable. - * + * * @param readable whether this memory byte is readable */ public void setReadable(boolean readable) { @@ -158,21 +158,21 @@ public class MemoryByte { if (!readable) flags ^= MemoryByte.READABLE; } - + /** * Returns whether this memory byte is readable. A memory byte * is considered readable when its value and attributes are * retrievable. - * + * * @return whether this memory byte is readable */ public boolean isReadable() { return ((flags & MemoryByte.READABLE) == MemoryByte.READABLE); } - + /** * Sets whether this memory byte is writable. - * + * * @param writable whether this memory byte is writable. */ public void setWritable(boolean writable) { @@ -180,19 +180,19 @@ public class MemoryByte { if (!writable) flags ^= MemoryByte.WRITABLE; } - + /** * Returns whether this memory byte is writable. - * + * * @return whether this memory byte is writable */ public boolean isWritable() { return ((flags & MemoryByte.WRITABLE) == MemoryByte.WRITABLE); } - + /** * Sets whether this memory byte has changed. - * + * * @param changed whether this memory byte has changed */ public void setChanged(boolean changed) { @@ -200,20 +200,20 @@ public class MemoryByte { if (!changed) flags ^= MemoryByte.CHANGED; } - + /** * Returns whether this memory byte has changed. - * + * * @return whether this memory byte has changed */ public boolean isChanged() { return ((flags & MemoryByte.CHANGED) == MemoryByte.CHANGED); } - + /** * Sets whether the history of this byte is known. When history * is unknown, the change state of a memory byte has no meaning. - * + * * @param known whether the change state of this byte is known */ public void setHistoryKnown(boolean known) { @@ -221,20 +221,20 @@ public class MemoryByte { if (!known) flags ^= MemoryByte.HISTORY_KNOWN; } - + /** * Returns whether the history of this byte is known. When history * is unknown, the change state of a memory byte has no meaning. - * + * * @return whether the change state of this byte is known */ public boolean isHistoryKnown() { return ((flags & MemoryByte.HISTORY_KNOWN) == MemoryByte.HISTORY_KNOWN); } - + /** * Sets whether this byte of memory is big endian. - * + * * @param isBigEndian whether the byte of memory is big endian. */ public void setBigEndian(boolean isBigEndian) @@ -243,22 +243,22 @@ public class MemoryByte { if (!isBigEndian) flags ^= MemoryByte.BIG_ENDIAN; } - + /** * Returns whether this byte of memory is big endian. - * + * * @return whether the byte of memory is big endian. */ public boolean isBigEndian() { return ((flags & MemoryByte.BIG_ENDIAN) == MemoryByte.BIG_ENDIAN); } - + /** * Sets whether the endianess of this byte of memory is known. * If the endianess is unknown, the endianess of this byte - * has no meaning. - * + * has no meaning. + * * @param isEndianessKnown whether the endianess of this byte is known. */ public void setEndianessKnown(boolean isEndianessKnown) @@ -267,17 +267,17 @@ public class MemoryByte { if (!isEndianessKnown) flags ^= MemoryByte.ENDIANESS_KNOWN; } - + /** * Returns whether the endianess of this byte of memory is known. * If the endianess is unknown, the endianess of this byte * has no meaning. - * + * * @return whether the endianess of this byte of memory is known. */ public boolean isEndianessKnown() { return ((flags & MemoryByte.ENDIANESS_KNOWN) == MemoryByte.ENDIANESS_KNOWN); } - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/IPersistableSourceLocator2.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/IPersistableSourceLocator2.java index f30b9712b..e314c9047 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/IPersistableSourceLocator2.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/IPersistableSourceLocator2.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -22,7 +22,7 @@ import org.eclipse.debug.core.model.IPersistableSourceLocator; * {@link org.eclipse.debug.core.model.IPersistableSourceLocator}. * </p> * @see org.eclipse.debug.core.model.IPersistableSourceLocator - * @since 3.0 + * @since 3.0 */ public interface IPersistableSourceLocator2 extends IPersistableSourceLocator { @@ -32,14 +32,14 @@ public interface IPersistableSourceLocator2 extends IPersistableSourceLocator { * is called instead of <code>initializeFrom(String memento)</code> * defined in <code>IPersistableSourceLocator</code> when a source * locator implements this interface. - * + * * @param memento a memento to initialize this source locator * @param configuration the launch configuration this source locator is * being created for - * @exception CoreException on failure to initialize + * @exception CoreException on failure to initialize */ public void initializeFromMemento(String memento, ILaunchConfiguration configuration) throws CoreException; - + /** * Disposes this source locator. This method is called when a source * locator's associated launch is removed from the launch manager. diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainer.java index ed721bd58..10fa07111 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainer.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainer.java @@ -33,11 +33,11 @@ import org.eclipse.core.runtime.IAdaptable; * @since 3.0 */ public interface ISourceContainer extends IAdaptable { - + /** * Notification this source container has been added to the given * source lookup director. - * + * * @param director the director this container has been added to */ public void init(ISourceLookupDirector director); @@ -66,7 +66,7 @@ public interface ISourceContainer extends IAdaptable { /** * The name of this source container that can be used for presentation purposes. * For example, the name of a project. - * + * * @return the name of this source container */ public String getName(); @@ -76,7 +76,7 @@ public interface ISourceContainer extends IAdaptable { * collection is returned if this container is not a composite container. * For example, a workspace source container may be composed of project source * containers. - * + * * @return the source containers this container is composed of, possibly * an empty collection * @exception CoreException if unable to retrieve source containers @@ -87,22 +87,22 @@ public interface ISourceContainer extends IAdaptable { * Returns whether this container is a composite container. A composite * container is composed of other source containers. For example, a workspace * source container may be composed of project source containers. - * + * * @return whether this container is a composite container - */ + */ public boolean isComposite(); - + /** * Returns this container's type. - * - * @return this container's type + * + * @return this container's type */ public ISourceContainerType getType(); - + /** * Disposes this source container. This method is called when the source * director associated with this source container is disposed. */ public void dispose(); - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerType.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerType.java index 0204389e6..548dcd988 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerType.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerType.java @@ -33,7 +33,7 @@ package org.eclipse.debug.core.sourcelookup; * </pre> * </p> * <p> - * Clients contributing a source container type implement + * Clients contributing a source container type implement * {@link org.eclipse.debug.core.sourcelookup.ISourceContainerTypeDelegate}. * </p> * @see org.eclipse.debug.core.sourcelookup.ISourceContainer @@ -50,7 +50,7 @@ public interface ISourceContainerType extends ISourceContainerTypeDelegate { * <code>Project</code>. The value returned is * identical to the name specified in plugin.xml by the <code>name</code> * attribute. - * + * * @return the name of this source container type */ public String getName(); @@ -59,17 +59,17 @@ public interface ISourceContainerType extends ISourceContainerTypeDelegate { * Returns the unique identifier associated with this source container type. * The value returned is identical to the identifier specified in plugin.xml by * the <code>id</code> attribute. - * + * * @return the unique identifier associated with this source container type */ public String getId(); - + /** * Returns a short description of this source container type that can be used * for presentation purposes, or <code>null</code> if none. - * + * * @return a short description of this source container type, or <code>null</code> */ public String getDescription(); - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerTypeDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerTypeDelegate.java index d8c944891..7b8a16648 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerTypeDelegate.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceContainerTypeDelegate.java @@ -23,7 +23,7 @@ import org.eclipse.core.runtime.CoreException; * </p> * <p> * Clients may implement this interface. - * </p> + * </p> * @see org.eclipse.debug.core.sourcelookup.ISourceContainer * @see org.eclipse.debug.core.sourcelookup.ISourceContainerType * @since 3.0 @@ -33,23 +33,23 @@ public interface ISourceContainerTypeDelegate { /** * Creates and returns a new source container of this type * corresponding to the given memento. - * + * * @param memento a memento for a source container of this source container type * @return a source container corresponding to the given memento * @exception CoreException if unable to construct a source container based * on the given memento */ public ISourceContainer createSourceContainer(String memento) throws CoreException; - + /** * Constructs and returns a memento for the given source container. A memento * can be used to reconstruct a source container. - * + * * @param container The container for which a memento should be created. The * container must of this source container type. * @return a memento for the source container * @exception CoreException if unable to create a memento */ public String getMemento(ISourceContainer container) throws CoreException; - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupDirector.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupDirector.java index 5eb45964a..2cee49968 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupDirector.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupDirector.java @@ -24,134 +24,134 @@ import org.eclipse.debug.core.ILaunchConfiguration; * @since 3.0 */ public interface ISourceLookupDirector extends IPersistableSourceLocator2 { - + /** - * Returns the launch configuration associated with this source + * Returns the launch configuration associated with this source * lookup director, or <code>null</code> if none. - * - * @return the launch configuration associated with this source + * + * @return the launch configuration associated with this source * lookup director, or <code>null</code> if none */ public ILaunchConfiguration getLaunchConfiguration(); - + /** * Returns the source lookup participants currently registered with * this director, possibly an empty collection. - * + * * @return the source lookup participants currently registered with * this director, possibly an empty collection */ public ISourceLookupParticipant[] getParticipants(); - + /** - * Returns the source containers currently registered with this + * Returns the source containers currently registered with this * director, possibly an empty collection. - * - * @return the source containers currently registered with this + * + * @return the source containers currently registered with this * director, possibly an empty collection */ public ISourceContainer[] getSourceContainers(); - + /** * Sets the source containers this source lookup director * should search when looking for source, possibly an empty collection. - * + * * @param containers the source containers this source lookup director * should search when looking for source, possibly an empty collection */ - public void setSourceContainers(ISourceContainer[] containers); - + public void setSourceContainers(ISourceContainer[] containers); + /** * Returns whether to search exhaustively for all source elements * with the same name in all registered source containers, or * whether to stop searching when the first source element matching * the required name is found. - * + * * @return whether to search exhaustively for all source elements * with the same name */ public boolean isFindDuplicates(); - + /** * Sets whether to search exhaustively for all source elements * with the same name in all registered source containers, or * whether to stop searching when the first source element matching * the required name is found. - * + * * @param findDuplicates whether to search exhaustively for all source elements * with the same name */ - public void setFindDuplicates(boolean findDuplicates); - + public void setFindDuplicates(boolean findDuplicates); + /** * Notifies this source lookup director that it should initialize * its set of source lookup participants. */ public void initializeParticipants(); - + /** * Returns whether this source director supports the given type - * of source location. - * + * of source location. + * * @param type source container type * @return whether this source director supports the given type * of source location */ public boolean supportsSourceContainerType(ISourceContainerType type); - + /** * Clears any source lookup results associated with the given * debug artifact, such that a subsequent lookup will force a new search * to be performed. - * + * * @param element debug artifact to clear source lookup results for */ public void clearSourceElements(Object element); - + /** * Adds the given source lookup participants to this director. - * + * * @param participants participants to add */ public void addParticipants(ISourceLookupParticipant[] participants); - + /** * Removes the given source lookup participants from this director. - * + * * @param participants participants to remove */ public void removeParticipants(ISourceLookupParticipant[] participants); - + /** * Returns the identifier of this type of source locator. - * + * * @return the identifier of this type of source locator */ public String getId(); - + /** * Returns the source path computer to use with this source lookup - * director, possibly <code>null</code>. By default, the source path + * director, possibly <code>null</code>. By default, the source path * computer returned is the one associated with this director's launch * configuration's type. However, the source path computer can be specified * programmatically by calling <code>setSourcePathComputer(...)</code>. - * + * * @return the source path computer to use with this source lookup * director, possibly <code>null</code> */ public ISourcePathComputer getSourcePathComputer(); - + /** * Sets the source path computer for this source lookup director. * This method can be used to override the default source path computer * for a launch configuration type. When <code>null</code> is specified * the default source path computer will be used (i.e. the one associated * with this director's launch configuration's type). - * + * * @param computer source path computer or <code>null</code> */ public void setSourcePathComputer(ISourcePathComputer computer); - + /** * Returns a collection of source elements corresponding to the given debug * artifact (for example, a stack frame or breakpoint). Returns an empty @@ -160,14 +160,14 @@ public interface ISourceLookupDirector extends IPersistableSourceLocator2 { * source elements should be searched for, via <code>isFindDuplicates()</code>. * When <code>false</code> the returned collection should contain at most one * source element. - * + * * @param object the debug artifact for which source needs to be found (e.g., stack frame) * @return a collection of source elements corresponding to the given * debug artifact, possibly empty * @exception CoreException if an exception occurs while searching for source */ - public Object[] findSourceElements(Object object) throws CoreException; - + public Object[] findSourceElements(Object object) throws CoreException; + /** * Returns a source element that corresponds to the given debug artifact, or * <code>null</code> if a source element could not be located. This is a @@ -175,8 +175,8 @@ public interface ISourceLookupDirector extends IPersistableSourceLocator2 { * source to be found for other types of elements. * * @param element the debug artifact for which to locate source - * @return an object representing a source element. + * @return an object representing a source element. */ - public Object getSourceElement(Object element); - + public Object getSourceElement(Object element); + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupParticipant.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupParticipant.java index b47d086c1..091b69a9e 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupParticipant.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourceLookupParticipant.java @@ -21,7 +21,7 @@ import org.eclipse.core.runtime.CoreException; * breakpoint, etc.), into a source name that can be recognized by a source container * (<code>ISourceContainer</code>), to search for source elements. Source containers * are generally debug model independent, whereas source lookup participants are - * debug model specific. + * debug model specific. * <p> * Clients may implement this interface. An abstract implementation is * provided by <code>AbstractSourceLookupParticipant</code>, which clients @@ -33,13 +33,13 @@ public interface ISourceLookupParticipant { /** * Notification this participant has been added to the specified - * source lookup director. + * source lookup director. * * @param director the source lookup director that this participant * has been added to */ public void init(ISourceLookupDirector director); - + /** * Returns a collection of source elements corresponding to the given debug * artifact (for example, a stack frame or breakpoint). Returns an empty @@ -60,29 +60,29 @@ public interface ISourceLookupParticipant { * @exception CoreException if an exception occurs while searching for source */ public Object[] findSourceElements(Object object) throws CoreException; - + /** * Returns the source file name associated with the given debug artifact that * source needs to be found for, or <code>null</code> if none. - * + * * @param object the debug artifact for which source needs to be found (e.g., stack frame) * @return the source file name associated with the given debug artifact, * or <code>null</code> if none. - * @throws CoreException if unable to determine a source file name + * @throws CoreException if unable to determine a source file name */ public String getSourceName(Object object) throws CoreException; /** * Disposes this source lookup participant. This method is called when - * the source lookup director associated with this participant is + * the source lookup director associated with this participant is * disposed. */ public void dispose(); - + /** * Notification that the source lookup containers in the given source * lookup director have changed. - * + * * @param director source lookup director that is directing this * participant */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputer.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputer.java index 3e9558979..59aa3a404 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputer.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputer.java @@ -16,7 +16,7 @@ import org.eclipse.debug.core.DebugPlugin; * A source path computer computes the default source lookup path (set of source * containers that should be considered) for a launch configuration. * <p> - * A source path computer is contributed in plug-in XML via the + * A source path computer is contributed in plug-in XML via the * <code>sourcePathComputers</code> extension point, that provides a delegate * to compute the path specific to a launch configuration. Following * is an example contribution. @@ -28,7 +28,7 @@ import org.eclipse.debug.core.DebugPlugin; * </sourcePathComputer> * </extension> * </pre> - * </p> + * </p> * <p> * A source path computer can be associated with a launch configuration type * via the <code>sourcePathComputerId</code> attribute of a launch configuration @@ -37,7 +37,7 @@ import org.eclipse.debug.core.DebugPlugin; * attribute. * </p> * <p> - * Clients contributing a source path computer provide an implementation of + * Clients contributing a source path computer provide an implementation of * {@link org.eclipse.debug.core.sourcelookup.ISourcePathComputerDelegate}. * </p> * @since 3.0 @@ -45,7 +45,7 @@ import org.eclipse.debug.core.DebugPlugin; * @noextend This interface is not intended to be extended by clients. */ public interface ISourcePathComputer extends ISourcePathComputerDelegate { - + /** * Launch configuration attribute to specify a source path computer * that should be used for a launch configuration. The value is an identifier @@ -57,9 +57,9 @@ public interface ISourcePathComputer extends ISourcePathComputerDelegate { /** * Returns the unique identifier for this source path computer. - * + * * @return the unique identifier for this source path computer */ public String getId(); - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputerDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputerDelegate.java index 9d5506190..51b17f6b6 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputerDelegate.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/ISourcePathComputerDelegate.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -19,7 +19,7 @@ import org.eclipse.debug.core.ILaunchConfiguration; * (set of source containers that should be considered) for a launch * configuration. * <p> - * A source path computer is contributed in plug-in XML via the + * A source path computer is contributed in plug-in XML via the * <code>sourcePathComputers</code> extension point, providing a delegate * to compute the default source lookup path specific to a launch * configuration. @@ -31,12 +31,12 @@ import org.eclipse.debug.core.ILaunchConfiguration; * @since 3.0 */ public interface ISourcePathComputerDelegate { - + /** * Returns a default collection source containers to be considered for the * given launch configuration. The collection returned represents the default * source lookup path for the given configuration. - * + * * @param configuration the launch configuration for which a default source lookup path * is to be computed * @param monitor a progress monitor to be used in case of long operations @@ -45,5 +45,5 @@ public interface ISourcePathComputerDelegate { * @exception CoreException if unable to compute a default source lookup path */ public ISourceContainer[] computeSourceContainers(ILaunchConfiguration configuration, IProgressMonitor monitor) throws CoreException; - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainerTypeDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainerTypeDelegate.java index bbbff4f76..e5ec1ad46 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainerTypeDelegate.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/sourcelookup/containers/AbstractSourceContainerTypeDelegate.java @@ -26,10 +26,10 @@ import org.w3c.dom.Element; * @since 3.0 */ public abstract class AbstractSourceContainerTypeDelegate implements ISourceContainerTypeDelegate { - + /** * Throws an exception with the given message and underlying exception. - * + * * @param message error message * @param exception underlying exception, or <code>null</code> * @throws CoreException if a problem is encountered @@ -38,20 +38,20 @@ public abstract class AbstractSourceContainerTypeDelegate implements ISourceCont IStatus status = new Status(IStatus.ERROR, DebugPlugin.getUniqueIdentifier(), DebugPlugin.ERROR, message, exception); throw new CoreException(status); } - + /** * Creates and returns a new XML document. - * + * * @return a new XML document * @throws CoreException if unable to create a new document */ protected Document newDocument()throws CoreException { return DebugPlugin.newDocument(); - } - + } + /** * Returns the given XML document as a string. - * + * * @param document document to serialize * @return the given XML document as a string * @throws CoreException if unable to serialize the document @@ -62,12 +62,12 @@ public abstract class AbstractSourceContainerTypeDelegate implements ISourceCont /** * Parses the given XML document, returning its root element. - * + * * @param document XML document as a string * @return the document's root element * @throws CoreException if unable to parse the document */ protected Element parseDocument(String document) throws CoreException { return DebugPlugin.parseDocument(document); - } + } } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/BreakpointImportParticipantDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/BreakpointImportParticipantDelegate.java index 72a93b1d6..6b6477999 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/BreakpointImportParticipantDelegate.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/BreakpointImportParticipantDelegate.java @@ -17,7 +17,7 @@ import org.eclipse.debug.core.model.IBreakpointImportParticipant; /** * Proxy to a breakpointImportParticipant extension. * Client can contribute participant through the <code>breakpointImportParticipant</code> extension point - * + * * Example contribution: * <pre> * <extension @@ -28,20 +28,20 @@ import org.eclipse.debug.core.model.IBreakpointImportParticipant; </ImportParticipant> </extension> * </pre> - * + * * @noextend This class is not intended to be sub-classed by clients. * @noinstantiate This class is not intended to be instantiated by clients. - * + * * @since 3.5 */ public class BreakpointImportParticipantDelegate { - + /** * The configuration element for this delegate */ private IConfigurationElement fElement = null; private IBreakpointImportParticipant fParticipant = null; - + /** * Constructor * @param element the element this proxy is created on @@ -53,7 +53,7 @@ public class BreakpointImportParticipantDelegate { /** * Returns the {@link IBreakpointImportParticipant} delegate or <code>null</code> of there was * a problem loading the delegate - * + * * @return the {@link IBreakpointImportParticipant} or <code>null</code> * @throws CoreException if a problem is encountered */ @@ -66,7 +66,7 @@ public class BreakpointImportParticipantDelegate { /** * Returns the marker type this participant is registered for. - * + * * @return the marker type this participant is registered for * @throws CoreException if a problem is encountered */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IConfigurationElementConstants.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IConfigurationElementConstants.java index 34dbb7eee..2e225285e 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IConfigurationElementConstants.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IConfigurationElementConstants.java @@ -21,25 +21,25 @@ public interface IConfigurationElementConstants { * <p>Equal to the word: <code>id</code></p> */ public static final String ID = "id"; //$NON-NLS-1$ - + /** * The name node name for a configuration element. * <p>Equal to the word: <code>name</code></p> */ public static final String NAME = "name"; //$NON-NLS-1$ - + /** * The category node name for a configuration element. * <p>Equal to the word: <code>category</code></p> */ public static final String CATEGORY = "category"; //$NON-NLS-1$ - + /** * The local node name for a configuration element. * <p>Equal to the word: <code>local</code></p> */ public static final String LOCAL = "local"; //$NON-NLS-1$ - + /** * The shortcutId node name for a configuration element. * <p>Equal to the word: <code>shortcutID</code></p> @@ -51,273 +51,273 @@ public interface IConfigurationElementConstants { * <p>Equal to the word: <code>launchPerspectives</code></p> */ public static final String LAUNCH_PERSPECTIVES = "launchPerspectives"; //$NON-NLS-1$ - + /** * The launchPerspective node name for a configuration element. * <p>Equal to the word: <code>launchPerspective</code></p> */ public static final String LAUNCH_PERSPECTIVE = "launchPerspective"; //$NON-NLS-1$ - + /** * The markerType node name for a configuration element. * <p>Equal to the word: <code>markerType</code></p> - * + * * @since 3.4 */ public static final String MARKER_TYPE = "markerType"; //$NON-NLS-1$ - + /** * The delegateClass node name for a configuration element. * <p>Equal to the word: <code>delegateClass</code></p> - * + * * @since 3.4 */ public static final String DELEGATE_CLASS = "delegateClass"; //$NON-NLS-1$ - + /** * The launchConfiguration node name for a configuration element. * <p>Equal to the word: <code>launchConfiguration</code></p> */ public static final String LAUNCH_CONFIGURATION = "launchConfiguration"; //$NON-NLS-1$ - + /** * The launchMode node name for a configuration element. * <p>Equal to the word: <code>launchMode</code></p> */ public static final String LAUNCH_MODE = "launchMode"; //$NON-NLS-1$ - + /** * The lastLaunch node name for a configuration element. * <p>Equal to the word: <code>lastLaunch</code></p> */ public static final String LAST_LAUNCH = "lastLaunch"; //$NON-NLS-1$ - + /** * The launch node name for a configuration element. * <p>Equal to the word: <code>launch</code></p> */ public static final String LAUNCH = "launch"; //$NON-NLS-1$ - + /** * The launch as label node name for a configuration element. * <p>Equal to the word: <code>launchAsLabel</code></p> - * + * * @since 3.4 */ public static final String LAUNCH_AS_LABEL = "launchAsLabel"; //$NON-NLS-1$ - + /** * The launchHistory node name for a configuration element. * <p>Equal to the word: <code>launchHistory</code></p> */ public static final String LAUNCH_HISTORY = "launchHistory"; //$NON-NLS-1$ - + /** * The node name for a launch group configuration element. * <p>Equal to the word: <code>launchGroup</code></p> */ public static final String LAUNCH_GROUP = "launchGroup"; //$NON-NLS-1$ - + /** * The node name for a launch history MRU list configuration element. * <p>Equal to the word: <code>mruHistory</code></p> */ - public static final String MRU_HISTORY = "mruHistory"; //$NON-NLS-1$ - + public static final String MRU_HISTORY = "mruHistory"; //$NON-NLS-1$ + /** * The node name for a launch favorites list configuration element. * <p>Equal to the word: <code>favorites</code></p> */ public static final String FAVORITES = "favorites"; //$NON-NLS-1$ - + /** * The after node name for a configuration element. * <p>Equal to the word: <code>after</code></p> */ public static final String AFTER = "after"; //$NON-NLS-1$ - + /** * The path node name for a configuration element. * <p>Equal to the word: <code>path</code></p> */ public static final String PATH = "path"; //$NON-NLS-1$ - + /** * The placement node name for a configuration element. * <p>Equal to the word: <code>placement</code></p> */ public static final String PLACEMENT = "placement"; //$NON-NLS-1$ - + /** * The associated launch delegate node name for a configuration element * <p>Equal to the word: <code>associatedDelegate</code></p> */ public static final String ASSOCIATED_DELEGATE = "associatedDelegate"; //$NON-NLS-1$ - + /** * The label node name for a configuration element. * <p>Equal to the word: <code>label</code></p> */ public static final String LABEL = "label"; //$NON-NLS-1$ - + /** * The description node name for a configuration element. * <p>Equal to the word: <code>description</code></p> */ public static final String DESCRIPTION = "description"; //$NON-NLS-1$ - + /** * The helpContextId node name for a configuration element. * <p>Equal to the word: <code>helpContextId</code></p> */ public static final String HELP_CONTEXT_ID = "helpContextId"; //$NON-NLS-1$ - + /** * The icon node name for a configuration element. * <p>Equal to the word: <code>icon</code></p> */ public static final String ICON = "icon"; //$NON-NLS-1$ - + /** * The public node name for a configuration element * <p>Equal to the word: <code>public</code></p> */ public static final String PUBLIC = "public"; //$NON-NLS-1$ - + /** * The perspective node name for a configuration element. * <p>Equal to the word: <code>perspective</code></p> */ public static final String PERSPECTIVE = "perspective"; //$NON-NLS-1$ - + /** * The preferredDelegates node name for a configuration element. * <p>Equal to the word: <code>preferredDelegates</code></p> */ public static final String PREFERRED_DELEGATES = "preferredDelegates"; //$NON-NLS-1$ - + /** * The modes node name for a configuration element. * <p>Equal to the word: <code>modes</code></p> */ public static final String MODES = "modes"; //$NON-NLS-1$ - + /** * The modesCombination node name for a configuration element. - * <p>Equal to the word: <code>modeCombination</code></p> + * <p>Equal to the word: <code>modeCombination</code></p> */ public static final String MODE_COMBINATION = "modeCombination"; //$NON-NLS-1$ - + /** * The mode node name for a configuration element. * <p>Equal to the word: <code>mode</code></p> */ public static final String MODE = "mode"; //$NON-NLS-1$ - + /** * The type node name for a configuration element. * <p>Equal to the word: <code>type</code></p> */ public static final String TYPE = "type"; //$NON-NLS-1$ - + /** * The typeid node name for a configuration element. - * <p>Equal to the word: <code>typeid</code></p> + * <p>Equal to the word: <code>typeid</code></p> */ public static final String TYPE_ID = "typeid"; //$NON-NLS-1$ - + /** * The option node name for a configuration element. * <p>Equal to the word: <code>options</code></p> */ public static final String OPTIONS = "options"; //$NON-NLS-1$ - + /** * The delegate node name for a configuration element. * <p>Equal to the word: <code>delegate</code></p> */ public static final String DELEGATE = "delegate"; //$NON-NLS-1$ - + /** * The participant node name for a configuration element. * <p>Equal to the word: <code>participant</code></p> */ public static final String PARTICIPANT = "participant"; //$NON-NLS-1$ - + /** * The defaultShortcut node name for a configuration element. * <p>Equal to the word: <code>defaultShortcut</code></p> */ public static final String DEFAULT_LAUNCH_SHORTCUT = "defaultShortcut"; //$NON-NLS-1$ - + /** * The delegateName node name for a configuration element. * <p>Equal to the word: <code>delegateName</code></p> */ public static final String DELEGATE_NAME = "delegateName"; //$NON-NLS-1$ - + /** * The group node name for a configuration element. * <p>Equal to the word: <code>group</code></p> */ public static final String GROUP = "group"; //$NON-NLS-1$ - + /** * The class node name for a configuration element. * <p>Equal to the word: <code>class</code></p> */ public static final String CLASS = "class"; //$NON-NLS-1$ - + /** * The modelIdentifier node name for a configuration element. * <p>Equal to the word: <code>modelIdentifier</code></p> - * + * * @since 3.4 */ public static final String MODEL_IDENTIFIER = "modelIdentifier"; //$NON-NLS-1$ - + /** * The configurationTypes node name for a configuration element. * <p>Equal to the word: <code>configurationType</code></p> */ public static final String CONFIGURATION_TYPES = "configurationType"; //$NON-NLS-1$ - + /** * The contextLabel node name for a configuration element. * <p>Equal to the word: <code>contextLabel</code></p> */ public static final String CONTEXT_LABEL = "contextLabel"; //$NON-NLS-1$ - + /** * The contextualLaunch node name for a configuration element. * <p>Equal to the word: <code>contextualLaunch</code></p> */ public static final String CONTEXTUAL_LAUNCH = "contextualLaunch"; //$NON-NLS-1$ - + /** * The sourcePathComputerId node name for a configuration element. * <p>Equal to the word: <code>sourcePathComputerId</code></p> */ public static final String SOURCE_PATH_COMPUTER = "sourcePathComputerId"; //$NON-NLS-1$ - + /** * The delegateDescription node name for a configuration element. * <p>Equal to the word: <code>delegateDescription</code></p> */ public static final String DELEGATE_DESCRIPTION = "delegateDescription"; //$NON-NLS-1$ - + /** * The sourceLocatorId node name for a configuration element. * <p>Equal to the word: <code>sourceLocatorId</code></p> */ public static final String SOURCE_LOCATOR = "sourceLocatorId"; //$NON-NLS-1$ - + /** * The migrationDelegate node name for a configuration element. * <p>Equal to the word: <code>migrationDelegate</code></p> */ public static final String MIGRATION_DELEGATE = "migrationDelegate"; //$NON-NLS-1$ - + /** * The memento node name for a configuration element. * <p>Equal to the word: <code>memento</code></p> diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IExpressionsListener2.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IExpressionsListener2.java index be3ee7dd8..11c359de7 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IExpressionsListener2.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IExpressionsListener2.java @@ -26,20 +26,20 @@ public interface IExpressionsListener2 extends IExpressionsListener { * <strong>must</strong> take into account the removal of the expressions to be removed. * Therefore, for each of the expressions being moved with indices lower than the expect * insertion index, the passed insertion index must be reduced by one. - * + * * @param expressions array of expressions to be moved * @param index the index the expressions will be added to, adjusted for moved expressions */ public void expressionsMoved(IExpression[] expressions, int index); - + /** * Fires the model delta necessary to update the viewer after one or more - * expressions have been inserted into a specific index in the tree. The + * expressions have been inserted into a specific index in the tree. The * expression array must be in the same order as they were added. - * + * * @param expressions array of expressions to be moved * @param index the index the expressions will be added to */ public void expressionsInserted(IExpression[] expressions, int index); - + } diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IInternalDebugCoreConstants.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IInternalDebugCoreConstants.java index 8fc33db5e..16239c423 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IInternalDebugCoreConstants.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IInternalDebugCoreConstants.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -15,7 +15,7 @@ import org.eclipse.debug.core.DebugPlugin; /** * Contains constants to be used internally in all debug components - * + * * @since 3.4 */ public interface IInternalDebugCoreConstants { @@ -24,19 +24,19 @@ public interface IInternalDebugCoreConstants { * Represents the empty string */ public static final String EMPTY_STRING = ""; //$NON-NLS-1$ - + /** * Boolean preference controlling whether status handler extensions * are enabled. Default value is <code>true</code>. When disabled * any call to {@link DebugPlugin#getStatusHandler(IStatus)} will return <code>null</code>. - * + * * @since 3.4.2 */ public static final String PREF_ENABLE_STATUS_HANDLERS = DebugPlugin.getUniqueIdentifier() + ".PREF_ENABLE_STATUS_HANDLERS"; //$NON-NLS-1$ /** * Persistence of breakpoint manager enabled state. - * + * * @since 3.6 */ public static final String PREF_BREAKPOINT_MANAGER_ENABLED_STATE = DebugPlugin.getUniqueIdentifier() + ".PREF_BREAKPOINT_MANAGER_ENABLED_STATE"; //$NON-NLS-1$ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IMementoConstants.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IMementoConstants.java index ed9f1e870..e0dfab43c 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IMementoConstants.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/IMementoConstants.java @@ -14,7 +14,7 @@ public interface IMementoConstants { // These persistence constant is stored in XML. Do not // change it. public static final String TAG_FACTORY_ID = "factoryID"; //$NON-NLS-1$ - + public static final String TAG_EDITOR_STATE = "editorState"; //$NON-NLS-1$ public static final String MEMENTO_ITEM = "item"; //$NON-NLS-1$ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/LogicalStructureProvider.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/LogicalStructureProvider.java index b478b3107..cb551ece4 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/LogicalStructureProvider.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/LogicalStructureProvider.java @@ -21,13 +21,13 @@ import org.eclipse.debug.core.model.IValue; /** * Manage logical structure provider extensions - * + * * @see IConfigurationElementConstants */ public class LogicalStructureProvider { private IConfigurationElement fConfigurationElement; - + private String fModelIdentifier; private ILogicalStructureProvider fDelegate; @@ -43,11 +43,11 @@ public class LogicalStructureProvider { throw new CoreException(new Status(IStatus.ERROR, DebugPlugin.getUniqueIdentifier(), DebugPlugin.ERROR, DebugCoreMessages.LogicalStructureProvider_1, null)); } } - + /** * Return the logical structure type able to provide a logical structure for * the given value. - * + * * @param value value for which structure types are requested * @return logical structure types */ diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/Preferences.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/Preferences.java index e79766c83..1e7995c8b 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/Preferences.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/Preferences.java @@ -21,24 +21,24 @@ import org.eclipse.debug.core.DebugPlugin; /** * Convenience class to facilitate using the new {@link IEclipsePreferences} story - * + * * @since 3.6 * @noinstantiate This class is not intended to be instantiated by clients. */ public final class Preferences { static final IScopeContext[] contexts= new IScopeContext[] { DefaultScope.INSTANCE, InstanceScope.INSTANCE }; - + static final int DEFAULT_CONTEXT = 0; static final int INSTANCE_CONTEXT = 1; - + /** * Constructor */ private Preferences() { // no direct instantiation } - + /** * Sets a string preference in the {@link InstanceScope} or the given {@link IScopeContext} if it * is not <code>null</code>. Preferences set in a given context are flushed as they are set. @@ -62,14 +62,14 @@ public final class Preferences { contexts[INSTANCE_CONTEXT].getNode(qualifier).put(key, value); } } - + /** * Sets a boolean preference in the {@link InstanceScope} or the given {@link IScopeContext} if it * is not <code>null</code>. Preferences set in a given context are flushed as they are set. * @param qualifier the preference qualifier * @param key the key * @param value the value - * @param context the context to set the value in + * @param context the context to set the value in */ public static synchronized void setBoolean(String qualifier, String key, boolean value, IScopeContext context) { if(context != null) { @@ -86,7 +86,7 @@ public final class Preferences { contexts[INSTANCE_CONTEXT].getNode(qualifier).putBoolean(key, value); } } - + /** * Sets a integer preference in the {@link InstanceScope} or the given {@link IScopeContext} if it * is not <code>null</code>. Preferences set in a given context are flushed as they are set. @@ -110,7 +110,7 @@ public final class Preferences { contexts[INSTANCE_CONTEXT].getNode(qualifier).putInt(key, value); } } - + /** * Sets a long preference in the {@link InstanceScope} or the given {@link IScopeContext} if it * is not <code>null</code>. Preferences set in a given context are flushed as they are set. @@ -134,7 +134,7 @@ public final class Preferences { contexts[INSTANCE_CONTEXT].getNode(qualifier).putLong(key, value); } } - + /** * Sets a byte array preference in the {@link InstanceScope} or the given {@link IScopeContext} if it * is not <code>null</code>. Preferences set in a given context are flushed as they are set. @@ -158,7 +158,7 @@ public final class Preferences { contexts[INSTANCE_CONTEXT].getNode(qualifier).putByteArray(key, value); } } - + /** * Sets a double preference in the {@link InstanceScope} or the given {@link IScopeContext} if it * is not <code>null</code>. Preferences set in a given context are flushed as they are set. @@ -182,7 +182,7 @@ public final class Preferences { contexts[INSTANCE_CONTEXT].getNode(qualifier).putDouble(key, value); } } - + /** * Sets a float preference in the {@link InstanceScope} or the given {@link IScopeContext} if it * is not <code>null</code>. Preferences set in a given context are flushed as they are set. @@ -206,7 +206,7 @@ public final class Preferences { contexts[INSTANCE_CONTEXT].getNode(qualifier).putFloat(key, value); } } - + /** * Sets a string in the {@link DefaultScope} * @param qualifier the preference qualifier @@ -216,7 +216,7 @@ public final class Preferences { public static synchronized void setDefaultString(String qualifier, String key, String value) { contexts[DEFAULT_CONTEXT].getNode(qualifier).put(key, value); } - + /** * Sets a boolean in the {@link DefaultScope} * @param qualifier the preference qualifier @@ -226,7 +226,7 @@ public final class Preferences { public static synchronized void setDefaultBoolean(String qualifier, String key, boolean value) { contexts[DEFAULT_CONTEXT].getNode(qualifier).putBoolean(key, value); } - + /** * Sets a byte array in the {@link DefaultScope} * @param qualifier the preference qualifier @@ -236,7 +236,7 @@ public final class Preferences { public static synchronized void setDefaultByteArray(String qualifier, String key, byte[] value) { contexts[DEFAULT_CONTEXT].getNode(qualifier).putByteArray(key, value); } - + /** * Sets a double in the {@link DefaultScope} * @param qualifier the preference qualifier @@ -246,7 +246,7 @@ public final class Preferences { public static synchronized void setDefaultDouble(String qualifier, String key, double value) { contexts[DEFAULT_CONTEXT].getNode(qualifier).putDouble(key, value); } - + /** * Sets a float in the {@link DefaultScope} * @param qualifier the preference qualifier @@ -256,7 +256,7 @@ public final class Preferences { public static synchronized void setDefaultFloat(String qualifier, String key, float value) { contexts[DEFAULT_CONTEXT].getNode(qualifier).putFloat(key, value); } - + /** * Sets a integer in the {@link DefaultScope} * @param qualifier the preference qualifier @@ -266,7 +266,7 @@ public final class Preferences { public static synchronized void setDefaultInt(String qualifier, String key, int value) { contexts[DEFAULT_CONTEXT].getNode(qualifier).putInt(key, value); } - + /** * Sets a long in the {@link DefaultScope} * @param qualifier the preference qualifier @@ -276,7 +276,7 @@ public final class Preferences { public static synchronized void setDefaultLong(String qualifier, String key, long value) { contexts[DEFAULT_CONTEXT].getNode(qualifier).putLong(key, value); } - + /** * Sets the given preference to its default value. This is done by removing any set value * from the {@link InstanceScope}. Has no effect if the given key is <code>null</code>. @@ -288,98 +288,98 @@ public final class Preferences { contexts[INSTANCE_CONTEXT].getNode(qualifier).remove(key); } } - + /** * Returns the default boolean value stored in the {@link DefaultScope} for the given key * or the specified default value if the key does not appear in the {@link DefaultScope} * @param qualifier the preference qualifier * @param key the preference key * @param defaultvalue the default value - * + * * @return the boolean value set in the {@link DefaultScope} for the given key, or the specified default value. */ public static synchronized boolean getDefaultBoolean(String qualifier, String key, boolean defaultvalue) { return contexts[DEFAULT_CONTEXT].getNode(qualifier).getBoolean(key, defaultvalue); } - + /** * Returns the default string value stored in the {@link DefaultScope} for the given key * or the specified default value if the key does not appear in the {@link DefaultScope} * @param qualifier the preference qualifier * @param key the preference key * @param defaultvalue the default value - * + * * @return the string value set in the {@link DefaultScope} for the given key, or the specified default value. */ public static synchronized String getDefaultString(String qualifier, String key, String defaultvalue) { return contexts[DEFAULT_CONTEXT].getNode(qualifier).get(key, defaultvalue); } - + /** * Returns the default byte array value stored in the {@link DefaultScope} for the given key * or the specified default value if the key does not appear in the {@link DefaultScope} * @param qualifier the preference qualifier * @param key the preference key * @param defaultvalue the default value - * + * * @return the byte array value set in the {@link DefaultScope} for the given key, or the specified default value. */ public static synchronized byte[] getDefaultByteArray(String qualifier, String key, byte[] defaultvalue) { return contexts[DEFAULT_CONTEXT].getNode(qualifier).getByteArray(key, defaultvalue); } - + /** * Returns the default integer value stored in the {@link DefaultScope} for the given key * or the specified default value if the key does not appear in the {@link DefaultScope} * @param qualifier the preference qualifier * @param key the preference key * @param defaultvalue the default value - * + * * @return the integer value set in the {@link DefaultScope} for the given key, or the specified default value. */ public static synchronized int getDefaultInt(String qualifier, String key, int defaultvalue) { return contexts[DEFAULT_CONTEXT].getNode(qualifier).getInt(key, defaultvalue); } - + /** * Returns the default long value stored in the {@link DefaultScope} for the given key * or the specified default value if the key does not appear in the {@link DefaultScope} * @param qualifier the preference qualifier * @param key the preference key * @param defaultvalue the default value - * + * * @return the long value set in the {@link DefaultScope} for the given key, or the specified default value. */ public static synchronized long getDefaultLong(String qualifier, String key, long defaultvalue) { return contexts[DEFAULT_CONTEXT].getNode(qualifier).getLong(key, defaultvalue); } - + /** * Returns the default double value stored in the {@link DefaultScope} for the given key * or the specified default value if the key does not appear in the {@link DefaultScope} * @param qualifier the preference qualifier * @param key the preference key * @param defaultvalue the default value - * + * * @return the double value set in the {@link DefaultScope} for the given key, or the specified default value. */ public static synchronized double getDefaultDouble(String qualifier, String key, double defaultvalue) { return contexts[DEFAULT_CONTEXT].getNode(qualifier).getDouble(key, defaultvalue); } - + /** * Returns the default float value stored in the {@link DefaultScope} for the given key * or the specified default value if the key does not appear in the {@link DefaultScope} * @param qualifier the preference qualifier * @param key the preference key * @param defaultvalue the default value - * + * * @return the float value set in the {@link DefaultScope} for the given key, or the specified default value. */ public static synchronized float getDefaultFloat(String qualifier, String key, float defaultvalue) { return contexts[DEFAULT_CONTEXT].getNode(qualifier).getFloat(key, defaultvalue); } - + /** * Save the preferences for the given plug-in identifier. * It should be noted that all pending preference changes will be flushed with this method. @@ -394,7 +394,7 @@ public final class Preferences { DebugPlugin.log(bse); } } - + /** * Adds the given preference listener to the {@link DefaultScope} and the {@link InstanceScope} * @param qualifier the preference qualifier @@ -404,7 +404,7 @@ public final class Preferences { contexts[DEFAULT_CONTEXT].getNode(qualifier).addPreferenceChangeListener(listener); contexts[INSTANCE_CONTEXT].getNode(qualifier).addPreferenceChangeListener(listener); } - + /** * Removes the given preference listener from the {@link DefaultScope} and the {@link InstanceScope} * @param qualifier the preference qualifier diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/PreferredDelegateModifyListener.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/PreferredDelegateModifyListener.java index 3a9fe1ba0..8b41847a2 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/PreferredDelegateModifyListener.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/PreferredDelegateModifyListener.java @@ -20,7 +20,7 @@ import org.osgi.service.prefs.BackingStoreException; /** * Used to listen for preference imports that include changes to preferred * launch delegates. - * + * * @since 3.6 TODO can we roll this into general preference listening? */ public class PreferredDelegateModifyListener extends PreferenceModifyListener { diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/ResourceFactory.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/ResourceFactory.java index 789cdd96a..d15558924 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/ResourceFactory.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/ResourceFactory.java @@ -32,7 +32,7 @@ public class ResourceFactory { /** * Creates and returns an element based on the given memento - * + * * @param memento element memento * @return associated element */ @@ -47,7 +47,7 @@ public class ResourceFactory { String type = memento.getString(TAG_TYPE); IResource res = null; if (type == null) { - // Old format memento. Create an IResource using findMember. + // Old format memento. Create an IResource using findMember. // Will return null for resources in closed projects. res = root.findMember(new Path(fileName)); } else { diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/SourceLocatorMementoComparator.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/SourceLocatorMementoComparator.java index 3e366e2f3..f02373235 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/SourceLocatorMementoComparator.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/SourceLocatorMementoComparator.java @@ -14,7 +14,7 @@ import java.util.Comparator; /** * Comparator for source locator mementos. Ignores whitespace differences. - * + * * @since 3.0 */ public class SourceLocatorMementoComparator implements Comparator<String> { diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/SourcePathComputer.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/SourcePathComputer.java index 996d14287..d9731c04c 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/SourcePathComputer.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/sourcelookup/SourcePathComputer.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ @@ -22,20 +22,20 @@ import org.eclipse.debug.internal.core.IConfigurationElementConstants; /** * Proxy to contributed source path computer extension. - * + * * @see IConfigurationElementConstants */ public class SourcePathComputer implements ISourcePathComputer { - + // lazily instantiated delegate private ISourcePathComputerDelegate fDelegate = null; - + // extension definition private IConfigurationElement fElement = null; - + /** * Constructs a source path computer on the given extension. - * + * * @param element extension definition */ public SourcePathComputer(IConfigurationElement element) { @@ -47,9 +47,9 @@ public class SourcePathComputer implements ISourcePathComputer { */ @Override public String getId() { - return fElement.getAttribute(IConfigurationElementConstants.ID); + return fElement.getAttribute(IConfigurationElementConstants.ID); } - + /** * Lazily instantiates and returns the underlying source container type. * @return the {@link ISourcePathComputerDelegate} diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/variables/Messages.java b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/variables/Messages.java index 5a3c4e08c..edc2babb7 100644 --- a/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/variables/Messages.java +++ b/org.eclipse.debug.core/core/org/eclipse/debug/internal/core/variables/Messages.java @@ -4,7 +4,7 @@ * 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 *******************************************************************************/ |