| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <html> |
| <head> |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2007. 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> |
| <p>These preferences allow you to configure options related to launching programs in general, and govern such things as waiting for builds, saving files before launching, etc. </p> |
| <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>Run/Debug > Launching</b></a> preference page. </p> |
| <table border="1" cellspacing="0" cellpadding="5" > |
| <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> |
| <tr> |
| <td align="left" valign="top">Launch Operation </td> |
| <td align="left" valign="top"><p>New in 3.3 is the ability to launch the selected resource or editor. The launch operation preference allows users to switch between using the old 'always launch last' behavior and the new 'launch selected resource or editor' behavior.</p> |
| <p>If the preference to use launch selected resource or editor is selected, you can then customize what happens if the selected resource or editor is not launchable. </p> |
| <p>There are two choices for this </p> |
| <ol> |
| <li> try to launch the parent project of the resource or editor </li> |
| <li>launch the previous thing you launched. </li> |
| </ol></td> |
| <td align="left" valign="top">Launch Selected with Launch Project </td> |
| </tr> |
| </tbody> |
| </table> |
| <p><img src="../../../images/ngrelc.png" alt="Related concepts" border="0"></p> |
| <p> <a href="../../../concepts/cdebugger.htm">Debugger</a><br> |
| <a href="../../../concepts/concepts-5.htm">Java perspectives</a><br> |
| <a href="../../../concepts/cjavaviews.htm">Java views</a><br> |
| <a href="../../../concepts/clocdbug.htm">Local debugging</a><br> |
| <a href="../../../concepts/cremdbug.htm">Remote debugging</a> </p> |
| <p> <img border="0" src="../../../images/ngrelt.png" alt="Related tasks" > </p> |
| <p> <a href="../../../tasks/task-launching_java_program.htm">Launching a Java program</a><br> |
| <a href="../../../tasks/task-running_and_debugging.htm">Running and debugging</a> </p> |
| <p><img src="../../../images/ngrelr.png" alt="Related reference" border="0"></p> |
| <p> <a href="../../../reference/ref-toolbar-run.htm">Run and Debug toolbar actions</a><br> |
| <a href="../../../reference/preferences/run-debug/ref-console.htm">Console Preferences</a><br> |
| <a href="../../../reference/preferences/run-debug/ref-default_launchers.htm">Default Launchers Preferences</a><br> |
| <a href="../../../reference/preferences/java/debug/ref-installed_jres.htm">Installed JREs Preferences</a> <br> |
| <a href="../../../reference/preferences/java/debug/ref-debug.htm">Java Debug Preferences </a><br> |
| <a href="../../../reference/preferences/run-debug/ref-launch_configurations.htm">Launch Configurations Preferences</a><br> |
| <a href="../../../reference/preferences/run-debug/ref-perspectives.htm">Perspectives Preferences</a> <br> |
| <a href="../../../reference/preferences/run-debug/ref-run_debug.htm">Run/Debug Preferences</a><br> |
| <a href="../../../reference/preferences/run-debug/ref-string_substitution.htm">String Substitution Preferences</a><br> |
| <a href="../../../reference/preferences/run-debug/ref-view_management.htm">View Management Preferences</a></p> |
| </body> |
| </html> |
