1 files changed, 123 insertions, 0 deletions
diff --git a/debug/org.eclipse.cdt.debug.application.doc/reference/cdt_u_run_dbg_launch_group.htm b/debug/org.eclipse.cdt.debug.application.doc/reference/cdt_u_run_dbg_launch_group.htm
new file mode 100644
index 00000000000..b8559e891c5
--- /dev/null
+++ b/debug/org.eclipse.cdt.debug.application.doc/reference/cdt_u_run_dbg_launch_group.htm
@@ -0,0 +1,123 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+
+<head>
+<meta http-equiv="Content-Language" content="en-us">
+<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
+<meta name="ProgId" content="FrontPage.Editor.Document">
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Group Launch Configuration</title>
+<link rel="stylesheet" type="text/css" href="../help.css">
+</head>
+<body>
+
+<div role="main"><h1>Launch Group</h1>
+
+<p>The user can launch multiple applications at the same time or in sequential order. This is made possible by the launch configuration type: <em>Launch Group</em>.</p>
+
+<h2>Launches tab</h2>
+<p>
+
+The <em>Launches</em> tab lets you add and delete launch configurations to the group.
+It also allows you to temporarily disable, re-order and edit properties of the elements in the group.
+
+</p>
+<img src="../images/run_debug_launch_group.png" alt="Run Configuration dialog, Launch group">
+<p></p>
+
+<table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" >
+<tr ><th id="component">Component</th><th id="description">Description</th></tr>
+<tr><td style="width:30%" headers="component"><strong>Name</strong></td><td headers="description">Displays the name of the launch configuration and a checkbox for enabling or disabling the configuration.</td></tr>
+<tr><td headers="component"><strong>Mode</strong></td><td headers="description">Displays the mode the configuration will run in when the group is launched.</td></tr>
+<tr><td headers="component"><strong>Action</strong></td><td headers="description">Displays the optional action that will be carried after the configuration is launched.</td></tr>
+<tr><td headers="component"><strong>Up</strong></td><td headers="description">Move selected configuration(s) up</td></tr>
+<tr><td headers="component"><strong>Down</strong></td><td headers="description">Move selected configuration(s) down</td></tr>
+<tr><td headers="component"><strong>Add...</strong></td><td headers="description">Opens a dialog to add a new configuration.</td></tr>
+<tr><td headers="component"><strong>Edit...</strong></td><td headers="description">Opens a dialog to edit values for configuration(s).</td></tr>
+<tr><td headers="component"><strong>Remove</strong></td><td headers="description">Removes selected configuration(s) from the list.</td></tr>
+
+</table>
+
+
+<h2>Common tab</h2>
+
+The <em>Common</em> tab lets you select where the configuration is stored, see <a href="cdt_u_run_dbg_comm.htm">Common tab reference</a> page for details.
+
+<h2>Add and Edit launch configuration Dialog</h2>
+<p>
+<img src="../images/run_debug_launch_group_edit.png"  alt="Edit Launch Configuration dialog">
+</p>
+
+<table width="580" fgcolor="#DDD" border="1" cellpadding="2" cellspacing="0" >
+<tr ><th id="component2">Component</th><th id="description2">Description</th></tr>
+<tr><td style="width:30%" headers="component2"><strong>Launch Mode</strong></td>
+  <td headers="description2">The Launch Mode combobox at the top of the dialog serves a dual purpose.
+  <ol>
+  <li>
+   It dictates the desired mode for the launch configuration being added,
+and </li>
+<li>
+   It establishes a 'mode' filter for the launch configurations that are
+exposed to the user (for selection) in the area below the combobox
+</li>
+</ol>
+<p>
+For example, when the 'debug' mode is selected, (1) only launch configurations
+that support being invoked in 'debug' mode appear. Also, (2) when the launch
+group is invoked, that particular child launch configuration will be invoked in
+'debug' mode.
+  </td></tr>
+<tr><td headers="component2"><strong>Filter input</strong></td><td headers="description2">Type in filter input to filter list of configurations by name</td></tr>
+<tr><td headers="component2"><strong>Configurations tree</strong></td><td headers="description2">Lists all available launch configurations for the selected Launch Mode, filtered by <em>Filter input</em>.</td></tr>
+<tr><td headers="component2"><strong>Use default mode when launching</strong></td>
+  <td headers="description2">
+This checkbox acts as a sort of override to whatever mode is set in the Launch Mode
+combobox. Checking this option indicates that the child launch configuration
+should be launched in the mode used to initiate the launch group launch. This
+needs some clarification. First, realize that a launch configuration can be
+invoked from either the 'Debug' or the 'Run' actions (and some comparable
+'profile' action in certain Eclipse configurations/products). That means, the
+launch group itself can be launched either in debug or run mode. When you check
+the <q>Use default...</q> checkbox, you're saying: <q>launch this particular child
+configuration in the mode that the parent (launch group) is launched with.</q> If
+you do not have that checkbox checked, then the child configurations will be
+invoked in whatever mode each individual child is configured with.
+<p>
+Note that <q>Use default...</q> control can allow you to create a launch group
+that will not be successful. For example when one or more launch configurations
+selected cannot be launched in the mode dictated by launch group mode.
+  </td></tr>
+<tr><td headers="component2"><strong>Post launch action</strong></td><td headers="description2">
+There are several actions available that control what should be done after each launch:
+<ul>
+<li>Delay - Waits a specified number of second before launching the next configuration in the group</li>
+<li>Wait until terminated - Waits until current launch is terminated</li>
+<li>None - Proceeds to launch next configuration immediately</li>
+</ul>
+</td></tr>
+
+</table>
+
+
+
+<p>
+
+
+
+
+
+<p><img src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
+<br>
+<a href="../concepts/cdt_c_over_dbg.htm">Debug overview</a><br>
+<a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p>
+<p><img src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
+<br>
+<a href="../tasks/cdt_o_run.htm">Running and debugging</a></p>
+<p><img src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
+<br>
+<a href="cdt_o_run_dbg_pages.htm">Run and Debug dialog box</a></p>
+<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >
+
+</div></body>
+
+</html>