removed old launch support

6 files changed, 20 insertions, 487 deletions

diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugPlugin.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugPlugin.java
index e8b9f671b..c6275a03a 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugPlugin.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/DebugPlugin.java
@@ -6,7 +6,6 @@ package org.eclipse.debug.core;
  */

 

 import java.text.MessageFormat;

-import java.util.ArrayList;

 import java.util.HashMap;

 

 import org.eclipse.core.resources.ResourcesPlugin;

@@ -21,7 +20,6 @@ import org.eclipse.debug.core.model.IProcess;
 import org.eclipse.debug.internal.core.BreakpointManager;

 import org.eclipse.debug.internal.core.ExpressionManager;

 import org.eclipse.debug.internal.core.LaunchManager;

-import org.eclipse.debug.internal.core.Launcher;

 import org.eclipse.debug.internal.core.ListenerList;

 import org.eclipse.debug.internal.core.RuntimeProcess;

 

@@ -47,15 +45,7 @@ public class DebugPlugin extends Plugin {
 	 * (value <code>"org.eclipse.debug.core"</code>).

 	 */

 	public static final String PLUGIN_ID = "org.eclipse.debug.core"; //$NON-NLS-1$

-	

-	/**

-	 * Simple identifier constant (value <code>"launchers"</code>) for the

-	 * launchers extension point.

-	 * 

-	 * @deprecated replaced with launch configurations

-	 */

-	public static final String EXTENSION_POINT_LAUNCHER= "launchers"; //$NON-NLS-1$

-	

+		

 	/**

 	 * Simple identifier constant (value <code>"launchConfigurationTypes"</code>)

 	 * for the launch configuration types extension point.

@@ -99,11 +89,6 @@ public class DebugPlugin extends Plugin {
 	private static DebugPlugin fgDebugPlugin= null;

 

 	/**

-	 * The collection of launcher extensions.

-	 */

-	private Launcher[] fLaunchers= new Launcher[0];

-

-	/**

 	 * The singleton breakpoint manager.

 	 */

 	private BreakpointManager fBreakpointManager;

@@ -273,20 +258,6 @@ public class DebugPlugin extends Plugin {
 	public IBreakpointManager getBreakpointManager() {

 		return fBreakpointManager;

 	}

-

-	/**

-	 * Returns a collection of launchers. Launchers represent

-	 * and provide access to launcher extensions, delaying

-	 * instantiation of the underlying delegate until

-	 * required.

-	 *

-	 * @return an array of launchers

-	 * @see org.eclipse.debug.core.model.ILauncherDelegate

-	 * @deprecated to be removed

-	 */

-	public ILauncher[] getLaunchers() {

-		return fLaunchers;

-	}

 	

 	/**

 	 * Returns the launch manager.

@@ -331,22 +302,6 @@ public class DebugPlugin extends Plugin {
 	}	

 

 	/**

-	 * Creates proxy launchers for all launcher delegates

-	 * defined in launcher extensions.

-	 *

-	 * @exception CoreException if creation of a launcher extension fails

-	 */

-	private void createLaunchers() throws CoreException {

-		IPluginDescriptor descriptor= getDescriptor();

-		IExtensionPoint extensionPoint= descriptor.getExtensionPoint(EXTENSION_POINT_LAUNCHER);

-		IConfigurationElement[] infos= extensionPoint.getConfigurationElements();

-		fLaunchers= new Launcher[infos.length];

-		for (int i= 0; i < infos.length; i++) {

-			fLaunchers[i]= new Launcher(infos[i]);

-		}

-	}	

-

-	/**

 	 * Removes the given listener from the collection of registered debug

 	 * event listeners. Has no effect if an identical listener is not already

 	 * registered.

@@ -407,7 +362,6 @@ public class DebugPlugin extends Plugin {
 		fLaunchManager= new LaunchManager();

 		fBreakpointManager= new BreakpointManager();

 		fExpressionManager = new ExpressionManager();

-		createLaunchers();	

 		fBreakpointManager.startup();

 		fLaunchManager.startup();

 		initializeStatusHandlers();

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 a8fd9ae0a..0a6b43161 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
@@ -5,8 +5,11 @@ package org.eclipse.debug.core;
  * All Rights Reserved.

  */

 

-import org.eclipse.debug.core.model.*;

 import org.eclipse.core.runtime.IAdaptable;

+import org.eclipse.debug.core.model.IDebugTarget;

+import org.eclipse.debug.core.model.IProcess;

+import org.eclipse.debug.core.model.ISourceLocator;

+import org.eclipse.debug.core.model.ITerminate;

 

 /**

  * A launch is the result of launching a debug session

@@ -36,23 +39,7 @@ public interface ILaunch extends ITerminate, IAdaptable {
 	 * @return the primary debug target associated with this launch, or <code>null</code>

 	 */

 	public IDebugTarget getDebugTarget();

-	/**

-	 * Returns the object that was launched. Cannot return <code>null</code>.

-	 * 

-	 * @return the launched object

-	 * @deprecated to be removed

-	 */

-	public Object getElement();

-	/**

-	 * Returns the launcher that was used to launch.

-	 * Returns <code>null</code> if this launch was 

-	 * the result of a launch configuration being

-	 * launched.

-	 *

-	 * @return the launcher, or <code>null</code>

-	 * @deprecated to be removed

-	 */

-	public ILauncher getLauncher();

+

 	/**

 	 * Returns the processes that were launched,

 	 * or an empty collection if no processes were launched.

diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchManager.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchManager.java
index 71c42a2c7..7a395e5eb 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchManager.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchManager.java
@@ -5,14 +5,12 @@ package org.eclipse.debug.core;
  * All Rights Reserved.

  */

  

-import org.eclipse.debug.core.model.IDebugTarget;

-import org.eclipse.debug.core.model.IPersistableSourceLocator;

-import org.eclipse.debug.core.model.IProcess;

 import org.eclipse.core.resources.IFile;

-import org.eclipse.core.resources.IProject;

 import org.eclipse.core.resources.IResource;

 import org.eclipse.core.runtime.CoreException;

-import org.eclipse.core.runtime.IAdaptable;

+import org.eclipse.debug.core.model.IDebugTarget;

+import org.eclipse.debug.core.model.IPersistableSourceLocator;

+import org.eclipse.debug.core.model.IProcess;

 

 /**

  * The launch manager manages the set of registered launches, maintaining

@@ -42,14 +40,6 @@ public interface ILaunchManager {
 	 */

 	public void addLaunchListener(ILaunchListener listener);

 	/**

-	 * Deregisters the specified launch and notifies listeners. Has no effect

-	 * if an identical launch is not already registered.

-	 *

-	 * @param launch the launch to deregister

-	 * @deprecated use removeLaunch(ILaunch)

-	 */

-	public void deregisterLaunch(ILaunch launch);

-	/**

 	 * Removes the specified launch and notifies listeners.

 	 * Has no effect if an identical launch is not already

 	 * registered.

@@ -59,24 +49,6 @@ public interface ILaunchManager {
 	 */

 	public void removeLaunch(ILaunch launch);	

 	/**

-	 * Returns the launch the given process is contained in, or <code>null</code>

-	 * if no registered launches contains the process.

-	 *

-	 * @param process the process for which to find a launch

-	 * @return the launch containing the process, or <code>null</code> if none

-	 * @deprecated debug elements should have a hard link to their launch

-	 */

-	public ILaunch findLaunch(IProcess process);

-	/**

-	 * Returns the launch the given debug target is contained

-	 * in, or <code>null</code> if no registered launches contain the debug target.

-	 *

-	 * @param target the debug target for which to find a launch

-	 * @return the launch containing the debug target, or <code>null</code> if none	 

-	 * @deprecated debug elements should have a hard link to their launch

-	 */

-	public ILaunch findLaunch(IDebugTarget target);

-	/**

 	 * Returns the collection of debug targets currently registered with this

 	 * launch manager.

 	 *

@@ -84,37 +56,6 @@ public interface ILaunchManager {
 	 */

 	public IDebugTarget[] getDebugTargets();

 	/**

-	 * Returns the default launcher for the given project,

-	 * or <code>null</code> if no default launcher has been set.

-	 * The default launcher is stored as a persistent property

-	 * with a project.

-	 *

-	 * @param project the project for which to retrieve a default launcher

-	 * @return the default launcher, or <code>null</code> if none has

-	 *   been set for the project

-	 * @exception CoreException if an error occurs accessing the

-	 *   persistent property

-	 * @deprecated to be removed

-	 */

-	public ILauncher getDefaultLauncher(IProject project) throws CoreException;

-	

-	/**

-	 * Returns the collection of registered launchers that can operate in the

-	 * specified mode - run or debug.

-	 *

-	 * @return an array of launchers

-	 * @deprecated to be removed

-	 */

-	public ILauncher[] getLaunchers(String mode);

-	

-	/**

-	 * Returns the collection of registered launchers.

-	 *

-	 * @return an array of launchers

-	 * @deprecated to be removed

-	 */

-	public ILauncher[] getLaunchers();

-	/**

 	 * Returns the collection of launches currently registered

 	 * with this launch manager.

 	 * 

@@ -129,15 +70,6 @@ public interface ILaunchManager {
 	 */

 	public IProcess[] getProcesses();

 	/**

-	 * Registers the specified launch with this launch manager

-	 * and notifies listeners. Has no effect if an identical

-	 * launch is already registered.

-	 * 

-	 * @param launch the launch to register

-	 * @deprecated use addLaunch(ILaunch)

-	 */

-	public void registerLaunch(ILaunch launch);

-	/**

 	 * Adds the specified launch and notifies listeners. Has no

 	 * effect if an identical launch is already registered.

 	 * 

@@ -153,16 +85,6 @@ public interface ILaunchManager {
 	 */

 	public void removeLaunchListener(ILaunchListener listener);

 	/**

-	 * Sets the default launcher for the given project as a persistent property.

-	 *

-	 * @param project the project for which to set the preference

-	 * @param launcher the default launcher preference

-	 * @exception CoreException if an error occurs setting the persistent property

-	 * @deprecated to be removed

-	 */

-	public void setDefaultLauncher(IProject project, ILauncher launcher) throws CoreException;

-	

-	/**

 	 * Returns all launch configurations defined in the workspace.

 	 * 

 	 * @return all launch configurations defined in the workspace

diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILauncher.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILauncher.java
deleted file mode 100644
index c3fbcf915..000000000
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILauncher.java
+++ /dev/null
@@ -1,108 +0,0 @@
-package org.eclipse.debug.core;

-

-/*

- * (c) Copyright IBM Corp. 2000, 2001.

- * All Rights Reserved.

- */

-

-import java.util.Set;

-

-import org.eclipse.core.runtime.IConfigurationElement;

-import org.eclipse.debug.core.model.ILauncherDelegate;

-

-/**

- * A launcher is a proxy to a launcher extension (<code>"org.eclipse.debug.core.launchers"</code>).

- * It manages the attributes of a launcher extension, and lazily instantiates the

- * delegate when required.

- * <p>

- * This interface is not intended to be implemented by clients. Clients

- * that define a launcher extension implement the <code>ILauncherDelegate</code>

- * interface.

- * </p>

- * <p>

- * <b>NOTE:</b> This class/interface is part of an interim API that is still under development and expected to 

- * change significantly before reaching stability. It is being made available at this early stage to solicit feedback 

- * from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken

- * (repeatedly) as the API evolves.

- * </p>

- * @see ILauncherDelegate

- * @deprecated to be replaced with ILaunchConfiguration/ILaunchConfigurationDelegate

- */

-public interface ILauncher {

-	/**

-	 * Returns the result of invoking this launcher's underlying

-	 * delegate's launch method. This causes the delegate to be instantiated

-	 * (if not already instantiated). 

-	 *

-	 * @param elements the elements providing context for the launch

-	 * @param mode the mode in which to launch - run or debug

-	 * @return whether the launch was successful

-	 * @see ILauncherDelegate

-	 */

-	public boolean launch(Object[] elements, String mode);

-	

-	/**

-	 * Returns the modes that the underlying launcher extension

-	 * supports - run and/or debug. This will not cause the extension to

-	 * be instantiated.

-	 *

-	 * @return a set of <code>String</code> constants - one or both of

-	 *	<code>ILaunchManager.RUN_MODE</code>, <code>ILaunchManager.DEBUG_MODE</code>

-	 * @see ILaunchManager

-	 */

-	public Set getModes();

-	

-	/**

-	 * Returns the identifier of the perspective associated with the 

-	 * underlying launcher extension. This attribute determines the layout

-	 * used by the debug UI plug-in when presenting this launch.

-	 * This will not cause the extension to be instantiated.

-	 *

-	 * @return a perspective identifier, as defined by the

-	 *    <code>"org.eclipse.ui.perspective"</code> extension point

-	 */

-	public String getPerspectiveIdentifier();

-	

-	/**

-	 * Returns the label defined by the underlying launcher extension.

-	 * This will not cause the extension to be instantiated.

-	 *

-	 * @return a human readable label

-	 */

-	public String getLabel();

-	

-	/**

-	 * Returns the configuration element associated with the underlying

-	 * extension. This will not cause the extension to be instantiated.

-	 *

-	 * @return the extension's configuration element

-	 */

-	public IConfigurationElement getConfigurationElement();

-	

-	/**

-	 * Returns the unique identifier of the underlying launcher extension.

-	 * This will not cause the extension to be instantiated.

-	 *

-	 * @return the extension's identifier attribute

-	 */

-	public String getIdentifier();

-	

-	/**

-	 * Returns the underlying launcher delegate associated with this

-	 * launcher. This causes the launcher delegate to be instantiated (if

-	 * not already instantiated).

-	 *

-	 * @return the underlying launcher delegate

-	 */

-	public ILauncherDelegate getDelegate();

-	

-	/**

-	 * Returns the icon path defined by the underlying launcher extension.

-	 * The path is relative to the plugin.xml of the contributing plug-in.

-	 * This will not cause the extension to be instantiated. Returns

-	 * <code>null</code> if no icon attribute is specified.

-	 *

-	 * @return a relative path to an icon or <code>null</code>

-	 */

-	public String getIconPath();	

-}

diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/Launch.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/Launch.java
index e29de0941..e0b7a9d1a 100644
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/Launch.java
+++ b/org.eclipse.debug.core/core/org/eclipse/debug/core/Launch.java
@@ -48,14 +48,9 @@ public class Launch extends PlatformObject implements ILaunch {
 	private List fTargets= new ArrayList();

 

 	/**

-	 * The element that was launched.

+	 * The configuration that was launched, or null.

 	 */

-	private Object fElement= null;

-

-	/**

-	 * The launcher that was used.

-	 */

-	private ILauncher fLauncher= null;

+	private ILaunchConfiguration fConfiguration= null;

 

 	/**

 	 * The system processes associated with

@@ -85,58 +80,7 @@ public class Launch extends PlatformObject implements ILaunch {
 	 * launch has been initialzied.

 	 */

 	private boolean fSuppressChange = true;

-	

-	/**

-	 * Constructs a launch with the specified attributes. A launch must

-	 * have at least one of a process or debug target.

-	 *

-	 * @param launcher the launcher that created this launch

-	 * @param mode the mode of this launch - run or debug (constants

-	 *  defined by <code>ILaunchManager</code>)

-	 * @param launchedElement the element that was launched

-	 * @param locator the source locator to use for this debug session, or

-	 * 	<code>null</code> if not supported

-	 * @param processes the processes created by this launch, empty

-	 *    or <code>null</code> if none

-	 * @param target the debug target created by this launch, or <code>null</code>

-	 *	if none 

-	 * @deprecated to be removed

-	 */

-	public Launch(ILauncher launcher, String mode, Object launchedElement, ISourceLocator locator, IProcess[] processes, IDebugTarget target) {

-		setLauncher(launcher);			

-		setElement(launchedElement);

-		setSourceLocator(locator);

-		addProcesses(processes);

-		addDebugTarget(target);

-		setLaunchMode(mode);

-		fSuppressChange = false;

-	}

-	

-	/**

-	 * Constructs a launch with the specified attributes.

-	 *

-	 * @param launchConfiguration the configuration that was launched

-	 * @param mode the mode of this launch - run or debug (constants

-	 *  defined by <code>ILaunchManager</code>)

-	 * @param launchedElement the element that was launched

-	 * @param locator the source locator to use for this debug session, or

-	 * 	<code>null</code> if not supported

-	 * @param processes the processes created by this launch, empty

-	 *    or <code>null</code> if none

-	 * @param target the debug target created by this launch, or <code>null</code>

-	 *	if none 

-	 * @deprecated to be removed

-	 */

-	public Launch(ILaunchConfiguration launchConfiguration, String mode, ISourceLocator locator, IProcess[] processes, IDebugTarget target) {

-		setLauncher(null);			

-		setElement(launchConfiguration);

-		setSourceLocator(locator);

-		addProcesses(processes);

-		addDebugTarget(target);

-		setLaunchMode(mode);

-		fSuppressChange = false;

-	}	

-	

+		

 	/**

 	 * Constructs a launch with the specified attributes.

 	 *

@@ -146,9 +90,8 @@ public class Launch extends PlatformObject implements ILaunch {
 	 * @param locator the source locator to use for this debug session, or

 	 * 	<code>null</code> if not supported

 	 */

-	public Launch(ILaunchConfiguration launchConfiguration, String mode, ISourceLocator locator) {

-		setLauncher(null);			

-		setElement(launchConfiguration);

+	public Launch(ILaunchConfiguration launchConfiguration, String mode, ISourceLocator locator) {		

+		setLaunchConfiguration(launchConfiguration);

 		setSourceLocator(locator);

 		setLaunchMode(mode);

 		fSuppressChange = false;

@@ -179,39 +122,14 @@ public class Launch extends PlatformObject implements ILaunch {
 		}

 		return null;

 	}

-	

-	/**

-	 * @see ILaunch#getElement()

-	 */

-	public final Object getElement() {

-		return fElement;

-	}

-	

-	/**

-	 * Sets the object that was launched

-	 * 

-	 * @param element the object that was launched

-	 */

-	private void setElement(Object element) {

-		fElement = element;

-	}	

-

-	/**

-	 * @see ILaunch#getLauncher()

-	 */

-	public final ILauncher getLauncher() {

-		return fLauncher;

-	}

-	

+		

 	/**

-	 * Sets the launcher that created

-	 * this launch.

+	 * Sets the configuration that was launched

 	 * 

-	 * @param launcher the launcher that created

-	 *  this launch

+	 * @param configuration the configuration that was launched

 	 */

-	private void setLauncher(ILauncher launcher) {

-		fLauncher = launcher;

+	private void setLaunchConfiguration(ILaunchConfiguration configuration) {

+		fConfiguration = configuration;

 	}	

 

 	/**

@@ -347,10 +265,7 @@ public class Launch extends PlatformObject implements ILaunch {
 	 * @see ILaunch#getLaunchConfiguration()

 	 */

 	public ILaunchConfiguration getLaunchConfiguration() {

-		if (getElement() instanceof ILaunchConfiguration) {

-			return (ILaunchConfiguration)getElement();

-		}

-		return null;

+		return fConfiguration;

 	}

 

 	/**

diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILauncherDelegate.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILauncherDelegate.java
deleted file mode 100644
index 648d37c5f..000000000
--- a/org.eclipse.debug.core/core/org/eclipse/debug/core/model/ILauncherDelegate.java
+++ /dev/null
@@ -1,137 +0,0 @@
-package org.eclipse.debug.core.model;

-

-/*

- * (c) Copyright IBM Corp. 2000, 2001.

- * All Rights Reserved.

- */

-

-import org.eclipse.debug.core.ILauncher;

-

-/**

- * A launcher delegate is an implementation of the

- * <code>org.eclipse.debug.core.launchers</code> extension point. The

- * debug plug-in creates a proxy to each launcher extension, and

- * lazily instantiates an extension when required. A launch delegate

- * starts a debug session with a specific debug model, and/or

- * launches one or more system processes, registering the result

- * with the launch manager. A launch delegate is also capable

- * of persisting and restoring elements that it can launch.

- * <p>

- * A launcher extension is defined in <code>plugin.xml</code>.

- * Following is an example definition of a launcher extension.

- * <pre>

- * &lt;extension point="org.eclipse.debug.core.launchers"&gt;

- *   &lt;launcher 

- *      id="com.example.ExampleIdentifier"

- *      class="com.example.ExampleLauncher"

- *      modes="run, debug"

- *      label="Example Launcher"

- *      wizard="com.example.ExampleLaunchWizard"

- *      layout="com.example.JavaLayout"&gt;

- *   &lt;/launcher&gt;

- * &lt;/extension&gt;

- * </pre>

- * The attributes are specified as follows:

- * <ul>

- * <li><code>id</code> specifies a unique identifier for this launcher.</li>

- * <li><code>class</code> specifies the fully qualified name of the java class

- *   that implements this interface.</li>

- * <li><code>modes</code> specifies a comma separated list of the modes this

- *    launcher supports - <code>"run"</code> and/or <code>"debug</code>.</li>

- * <li><code>label</code> specifies a human readable label for this launcher

- *    extension.</li>

- * <li><code>wizard</code> specifies the fully qualified name of the java class

- *    that implements <code>org.eclipse.debug.ui.ILaunchWizard</code>. The debug UI

- *    may invoke the wizard to perform a launch, or this launcher extension

- *    may present the wizard when asked to launch.</li>

- * <li></code>layout</code> specifies the identifier of a layout that should be

- *    used to present the resulting launch.</li>

- * </ul>

- * </p>

- * <p>

- * Clients may implement this interface.

- * </p>

- * <p>

- * <b>Note:</b> This class/interface is part of an interim API that is still under development and expected to 

- * change significantly before reaching stability. It is being made available at this early stage to solicit feedback 

- * from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken

- * (repeatedly) as the API evolves.

- * </p>

- * @see org.eclipse.debug.core.ILaunch

- * @see org.eclipse.debug.core.Launch

- * @see org.eclipse.debug.core.ILaunchManager

- * @see org.eclipse.debug.core.ILauncher

- * 

- * @deprecated to be replaced with ILaunchConfiguration/ILaunchConfigurationDelegate

- */

-public interface ILauncherDelegate {

-	/**

-	 * Notifies this launcher delegate to launch in the given mode, and

-	 * registers the resulting launch with  the launch manager.

-	 * Returns <code>true</code> if successful, otherwise <code>false</code>.

-	 * This typically results in the creation of one or more processes and/or

-	 * a debug target. The collection of elements provides context for the 

-	 * launch. The determination of which or how many objects to launch

-	 * is launcher dependent. This method blocks until the launch is

-	 * complete. The given launcher is the owner of this delegate.

-	 * <p>

-	 * For example, when the debug UI invokes a launcher, the

-	 * collection of elements passed in could represent the selected elements

-	 * in the UI, and the mode specified will be run or debug (depending on

-	 * which launch button was pressed). A launcher will generally examine the 

-	 * element collection to determine what to launch. For example, if the

-	 * collection contains one launchable program, or one runnable program

-	 * can be inferred from the collection, the launcher will launch

-	 * that program. If the collection contains more than one runnable

-	 * program, or more than one runnable program can be inferred from the

-	 * collection, the launcher may ask the user to select a program to launch.

-	 * </p>

-	 * <p>

-	 * Launching the program itself usually requires running an external

-	 * program specific to a debug architecture/debug model, and wrapping the

-	 * result in a debug target or process that can be registered in a launch object. 

-	 * </p>

-	 *

-	 * @param elements an array of objects providing a context for the launch

-	 * @param mode run or debug (as defined by <code>ILaunchManager.RUN_MODE</code>,

-	 *    <code>ILaunchManager.DEBUG_MODE</code>)

-	 * @param launcher the proxy to this lazily instantiated extension which needs

-	 *    to be supplied in the resulting launch object

-	 * @return whether the launch succeeded

-	 *

-	 * @see org.eclipse.debug.core.ILaunch

-	 * @see org.eclipse.debug.core.Launch

-	 * @see IDebugTarget

-	 * @see IProcess

-	 * @see org.eclipse.debug.core.ILaunchManager#registerLaunch

-	 */

-	public boolean launch(Object[] elements, String mode, ILauncher launcher);

-	

-	/**

-	 * Returns a memento for an object that this delegate has launched, such

-	 * that launched elements can be persisted across workspace invocations.

-	 * The memento is used to re-create the launched element.

-	 * 

-	 * @param element an element this delegate has launched

-	 * @return a String representing a memento for the given element,

-	 *		or <code>null</code> if unable to create a memento for

-	 * 		the element

-	 * 

-	 * @see #getLaunchObject

-	 */

-	public String getLaunchMemento(Object element);

-	

-	/**

-	 * Returns the object represented by the given memento, or <code>null</code>

-	 * if unable to re-create an element from the given memento, or if

-	 * the given object no longer exists.

-	 * 

-	 * @param memento a memento created by this delegate

-	 * @return the object represented by the memento, or <code>null</code>

-	 * 

-	 * @see #getLaunchMemento

-	 */

-	public Object getLaunchObject(String memento);

-}

-

-