blob: 3c0befa911da0b4cb1a5532892d2f84b1afc0859 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. 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>
Debug 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>
Debug preferences
</h1>
<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.DebugPreferencePage)")'>
<img src="PLUGINS_ROOT/org.eclipse.help/command_link.png">
<b>Run/Debug</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">
<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> Reuse editor when displaying source code </p>
</td>
<td align="left" valign="top">
<p> The debugger displays source code in an editor when stepping through
an application. When this option is on, the debugger will reuse the editor
that it opened to display source from different source files. This prevents
the debugger from opening an excessive number of editors. When this option
is off, the debugger will open a new editor for each source file that
needs to be displayed. </p>
</td>
<td align="left" valign="top">
<p> On </p>
</td>
</tr>
<tr>
<td align="left" valign="top">Activate the workbench when when a breakpoint
is hit</td>
<td align="left" valign="top">This option brings attention to the debugger
when a breakpoint is encountered, by activating the associated window. The
visual result varies from platform to platform. For example, on Windows,
the associated window's title bar will flash.</td>
<td align="left" valign="top">On</td>
</tr>
<tr>
<td align="left" valign="top">
<p> Save dirty editors before launching </p>
</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> 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>
<li> Auto-save - when this option is selected, any dirty editors are automatically
saved before launching (and the user is not prompted). </li>
</ul>
</td>
<td align="left" valign="top">
<p> Prompt </p>
</td>
</tr>
</tbody>
</table>
<p>
<img src="../images/ngrelc.png" alt="Related concepts" border="0" >
</p>
<p>
<a href="../concepts/concepts-10.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/tasks-133.htm">Preparing to Debug</a><br>
<a href="../tasks/tasks-126.htm">Running and Debugging</a>
</p>
<p>
<img src="../images/ngrelr.png" alt="Related reference" border="0" >
</p>
<p>
<a href="ref-131.htm">Java search tab</a><br>
<a href="ref-menu-search.htm">Search menu</a>
</p>
</body>
</html>