| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//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"> |
| <link rel="stylesheet" href="../../../../book.css" charset="ISO-8859-1" type="text/css"> |
| <title>Java Debug Preferences</title> |
| <script language="JavaScript" src="../../../../PLUGINS_ROOT/org.eclipse.help/livehelp.js"> </script> |
| </head> |
| <body> |
| <h1> Java 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.jdt.debug.ui.JavaDebugPreferencePage)")'> <img src="../PLUGINS_ROOT/org.eclipse.help/command_link.png" alt="Opens the Java Debug preference page"> <b>Java > Debug</b></a> preference page.</p> |
| <p>These options apply to java specific debuggers and have to do with suspending options and hot code replace. </p> |
| <table border="1" cellspacing="0" cellpadding= "5"> |
| <thead> |
| <tr> |
| <th rowspan="1" colspan="1"> <p> Option </p></th> |
| <th rowspan="1" colspan="1"> <p> Description </p></th> |
| <th rowspan="1" colspan="1"> <p> Default </p></th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr> |
| <td colspan="1" valign="top" align="left">Suspend execution on uncaught exceptions </td> |
| <td colspan="1" valign="top" align="left"><p>This option controls if a program will suspend if an uncaught exception is thrown. </p> |
| <p>For example if you try to call a method on a null object and a NullPointerException is thrown, with this option on your prgram will suspend at the location the exception was thrown </p></td> |
| <td colspan="1" valign="top" align="left">On</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Suspend execution on compilation errors </td> |
| <td colspan="1" valign="top" align="left">This option controls if a program will suspend when a compilation error is encountered </td> |
| <td colspan="1" valign="top" align="left">On</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Suspend on breakpoints during evaluations </td> |
| <td colspan="1" valign="top" align="left">This options controls if breakpoints will suspend during an evaluation of code containing a breakpoint. For more information about evaluations go <a href="../../../../tasks/task-evaluating_expressions.htm">here</a> </td> |
| <td colspan="1" valign="top" align="left">On</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Open popup when suspended on exception </td> |
| <td colspan="1" valign="top" align="left">This option controls if a popup window will be displayed when execution of a program stops on an exception. The exception the program suspended on is made available for inspection in the popup</td> |
| <td colspan="1" valign="top" align="left">Off</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Default suspend policy for new breakpoints </td> |
| <td colspan="1" valign="top" align="left">This option allows the default suspend policy to be set for new breakpoints. The suspend policy is used by breakpoints to tell the VM what to suspend, in this case either the thread the breakpoint is active in or the entire running VM </td> |
| <td colspan="1" valign="top" align="left">Suspend Thread </td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Show error when hot code replace fails </td> |
| <td colspan="1" valign="top" align="left">This option controls if the user will be presented with an error dialog when a hot code replace fails </td> |
| <td colspan="1" valign="top" align="left">On</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Show error when hot code replace is not supported </td> |
| <td colspan="1" valign="top" align="left">This option controls if the user will be presented with an error dialog when hot code replace is not supported, and the user has made and saved changes to currently running code </td> |
| <td colspan="1" valign="top" align="left">On</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Show error when obsolete methods remain after hot code replace </td> |
| <td colspan="1" valign="top" align="left">This option controls if the user will be presented with an error dialog when a hot code replace completed, but there were obsolete methods left over </td> |
| <td colspan="1" valign="top" align="left">On</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Replace class files containing compilation errors </td> |
| <td colspan="1" valign="top" align="left">This option controls is class files containing compilation errors will be replaced </td> |
| <td colspan="1" valign="top" align="left">On</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Debugger timeout </td> |
| <td colspan="1" valign="top" align="left">This option describes the length of time (in milliseconds) the debugger will wait trying to communicate with a running VM before giving up and disconnecting </td> |
| <td colspan="1" valign="top" align="left">3000</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Launch timeout </td> |
| <td colspan="1" valign="top" align="left">This option describes the length of time (in milliseconds) that a launch will wait to complete the launching process before giving up and terminating. This option has no bearing on the length of time a program will run, only how long the process of <em>trying</em> to run a program will wait </td> |
| <td colspan="1" valign="top" align="left">20000</td> |
| </tr> |
| <tr> |
| <td colspan="1" valign="top" align="left">Warn when unable to install breakpoint due to missing line number attributes </td> |
| <td colspan="1" valign="top" align="left">This option controls if the user will be notified if they try to set a line breakpoint on a line that has invalid line information </td> |
| <td colspan="1" valign="top" align="left">On</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/preferences/java/debug/ref-detail_formatters.htm">Detail Formatters Preferences</a><br> |
| <a href="../../../../reference/preferences/java/debug/ref-heap_walking.htm">Heap Walking 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-logical_structures.htm">Logical Structures Preferences</a> <br> |
| <a href="../../../../reference/preferences/java/debug/ref-primitive_display_options.htm">Primitive Display Preferences</a> <br> |
| <a href="../../../../reference/preferences/run-debug/ref-run_debug.htm">Run/Debug Preferences</a><br> |
| <a href="../../../../reference/preferences/java/debug/ref-step_filtering.htm">Step Filtering Preferences </a> </p> |
| </body> |
| </html> |
