diff --git a/build/org.eclipse.cdt.make.core/src/org/eclipse/cdt/make/core/MakeTargetEvent.java b/build/org.eclipse.cdt.make.core/src/org/eclipse/cdt/make/core/MakeTargetEvent.java index 2287103c1ef..bc25453e162 100644 --- a/build/org.eclipse.cdt.make.core/src/org/eclipse/cdt/make/core/MakeTargetEvent.java +++ b/build/org.eclipse.cdt.make.core/src/org/eclipse/cdt/make/core/MakeTargetEvent.java @@ -16,6 +16,9 @@ import java.util.EventObject; import org.eclipse.core.resources.IProject; /** + * This class represents an event sent when the set of Make Target items + * in Make Targets View has changed. + * * @noextend This class is not intended to be subclassed by clients. * @noinstantiate This class is not intended to be instantiated by clients. */ @@ -28,12 +31,13 @@ public class MakeTargetEvent extends EventObject { public static final int PROJECT_ADDED = 4; public static final int PROJECT_REMOVED = 5; - IMakeTarget[] targets; - IProject project; - int type; + private IMakeTarget[] targets; + private int type; /** - * @param source + * @param source - the object on which the Event initially occurred. + * @param type - event type (e.g. TARGET_ADD, TARGET_CHANGED) + * @param target - make target affected */ public MakeTargetEvent(Object source, int type, IMakeTarget target) { super(source); @@ -42,11 +46,11 @@ public class MakeTargetEvent extends EventObject { } /** - * @param source - * @param type event type (e.g. TARGET_ADD, TARGET_CHANGED) - * @param targets array of MakeTargets - * @since 7.0 + * @param source - the object on which the Event initially occurred. + * @param type - event type (e.g. TARGET_ADD, TARGET_CHANGED) + * @param targets - array of MakeTargets * + * @since 7.0 */ public MakeTargetEvent(Object source, int type, IMakeTarget[] targets) { super(source); @@ -55,10 +59,14 @@ public class MakeTargetEvent extends EventObject { System.arraycopy(targets, 0, this.targets, 0, targets.length); } + /** + * @param source - the object on which the Event initially occurred. + * @param type - event type (e.g. TARGET_ADD, TARGET_CHANGED) + * @param project - not used + */ public MakeTargetEvent(Object source, int type, IProject project) { super(source); this.type = type; - this.project = project; } public int getType() { @@ -66,8 +74,9 @@ public class MakeTargetEvent extends EventObject { } /** - * @deprecated - * Use getTargets() instead. + * @return the first target (for compatibility with old method). + * + * @deprecated Use getTargets() instead. */ @Deprecated public IMakeTarget getTarget() { @@ -75,6 +84,8 @@ public class MakeTargetEvent extends EventObject { } /** + * @return MakeTargets passed in this event. + * * @since 7.0 */ public IMakeTarget[] getTargets() {