blob: d87e399053280b61165e20fd2af0b3006fcbce14 [file]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta http-equiv="Content-Style-Type" content="text/css">
<meta name="GENERATOR" content="Mozilla/4.75 [en] (Windows NT 5.0; U) [Netscape]">
<title>
Launching preferences
</title>
<link rel="stylesheet" href="../../book.css" charset="ISO-8859-1" type="text/css">
<script language="JavaScript" src="../PLUGINS_ROOT/org.eclipse.help/livehelp.js"> </script>
</head>
<body>
<h1> Launching preferences </h1>
<hr>
<p>
The following preferences can be set using the
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.debug.ui.LaunchingPreferencePage)")'>
<img src="../PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="Opens the Launching preference page">
<b>Launching</b></a> preference page.
</p>
<table border="1" cellspacing="0" cellpadding="5" >
<caption>
<br>
</caption>
<tbody>
<tr>
<th> <p> Option </p></th>
<th> <p> Description </p></th>
<th> <p> Default </p></th>
</tr>
<tr>
<td align="left" valign="top">Save required dirty editors before launching
</td>
<td align="left" valign="top"><p>This option controls whether the user will
be prompted to save any dirty editors before an application is launched.
The allowable settings are: </p>
<ul>
<li> Always - when this option is selected, the user is never prompted
to save dirty editors, and editors are automatically saved. </li>
<li>Never - when this option is selected, the user is never prompted
to save dirty editors, and editors are not automatically saved. </li>
<li> Prompt - when this option is selected, the user is prompted to
save dirty editors before launching an application.</li>
</ul></td>
<td align="left" valign="top">Prompt </td>
</tr>
<tr>
<td align="left" valign="top">Wait for ongoing build to complete before
launching </td>
<td align="left" valign="top"><p>This option controls whether a launch will
wait for an already executing build to complete before launching an
application. The allowable settings are:</p>
<ul>
<li>Always - when this option is selected, a launch will always wait
for the pending build to complete</li>
<li>Never - when this option is selected, a launch will never wait for
the pending build to complete</li>
<li>Prompt - when this option is selected, the user is prompted to wait
for the pending build to complete when they launch</li>
</ul></td>
<td align="left" valign="top">Always</td>
</tr>
<tr>
<td align="left" valign="top">Launch in debug mode whenever the workspace
contains breakpoints</td>
<td align="left" valign="top"><p>This option controls whether a launch will
be performed in debug mode, even when run is pressed, when the workspace
contains breakpoints. The allowable options are:</p>
<ul>
<li>Always - when this option is selected, a launch will always be performed
in debug mode when breakpoints are present, no matter which launch
button is pressed (run or debug)</li>
<li>Never - when this option is selected, a launch will always be performed
in the user specified mode</li>
<li>Prompt - when this option is selected, the user is prompted to launch
in debug mode when the workspace contains breakpoints</li>
</ul></td>
<td align="left" valign="top">Never</td>
</tr>
<tr>
<td align="left" valign="top">Continue launch if project contains errors</td>
<td align="left" valign="top"><p>This option controls whether a launch should
be performed when a related project contains an error. The allowable
options are:</p>
<ul>
<li>Always - when this option is selected, a launch will continue in
the face of compilation errors</li>
<li>Prompt - when this option is selected, the user is prompted to proceed
with a launch when relevant compilation errors are in an associated
project </li>
</ul></td>
<td align="left" valign="top">Prompt</td>
</tr>
<tr>
<td align="left" valign="top"> <p> Build (if required) before launching
</p></td>
<td align="left" valign="top"> <p> If the workspace requires building, an
incremental build will be performed prior to launching an application.
</p></td>
<td align="left" valign="top"> <p> On </p></td>
</tr>
<tr>
<td align="left" valign="top"> <p> Remove terminated launches when a new
launch is created </p></td>
<td align="left" valign="top"> <p> When an application is launched, all
terminated applications in the Debug view are automatically cleared.
</p></td>
<td align="left" valign="top"> <p> On</p></td>
</tr>
<tr>
<td align="left" valign="top"> <p> Size of recently launched applications
list </p></td>
<td align="left" valign="top"> <p> This option controls how many launches
will appear in the Run/Debug pull-down launch history menus.</p></td>
<td align="left" valign="top"> <p> 10</p></td>
</tr>
</tbody>
</table>
<hr>
<p><img src="../../images/ngrelc.png" alt="Related concepts" border="0" >
</p>
<p>
<a href="../../concepts/cdebugger.htm">Debugger</a><br>
<a href="../../concepts/clocdbug.htm">Local Debugging</a><br>
<a href="../../concepts/cremdbug.htm">Remote Debugging</a>
</p>
<p>
<img src="../../images/ngrelt.png" alt="Related Tasks" border="0" >
</p>
<p>
<a href="../../tasks/tasks-9.htm">Changing Debugger Launch Options</a><br>
<a href="../../tasks/task-preparing_to_debug.htm">Preparing to Debug</a><br>
<a href="../../tasks/task-running_and_debugging.htm">Running and Debugging</a>
</p>
<p>&nbsp;</p>
</body>
</html>