diff --git a/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/debug/service/IBreakpointsExtension.java b/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/debug/service/IBreakpointsExtension.java index 875a95e58e2..56cfaec6f96 100644 --- a/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/debug/service/IBreakpointsExtension.java +++ b/dsf/org.eclipse.cdt.dsf/src/org/eclipse/cdt/dsf/debug/service/IBreakpointsExtension.java @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2008 Wind River Systems and others. + * Copyright (c) 2010 Wind River Systems and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -15,7 +15,7 @@ import org.eclipse.cdt.dsf.debug.service.IRunControl.IExecutionDMContext; import org.eclipse.cdt.dsf.debug.service.IRunControl.ISuspendedDMEvent; /** - * Extension to the Breakpoints service which adds support for corollating + * Extension to the Breakpoints service which adds support for correlating * breakpoints and execution contexts. * @since 2.1 */ @@ -28,7 +28,7 @@ public interface IBreakpointsExtension extends IBreakpoints { public interface IBreakpointHitDMEvent extends ISuspendedDMEvent { /** - * Returs the breakpoints that suspended the thread. + * Returns the breakpoints that suspended the thread. */ IBreakpointDMContext[] getBreakpoints(); } @@ -37,9 +37,13 @@ public interface IBreakpointsExtension extends IBreakpoints { * If a given execution context was suspended due hitting a breakpoint, * this method should return the breakpoints which caused the thread or * container to suspend. + *

+ * If the given thread is not suspended or is not suspended at a + * breakpoint, an empty array or an error with an INVALID_STATE code + * will be returned. * * @param ctx Thread or container to get breakpoints for. - * @param rm Breakpoints that the thread suspended on. + * @param rm Breakpoints that the thread or container is suspended on. */ public void getExecutionContextBreakpoints(IExecutionDMContext ctx, DataRequestMonitor rm); }