~ubuntu-branches/ubuntu/quantal/netbeans/quantal

« back to all changes in this revision

Viewing changes to java/helpset/javahelp/org/netbeans/modules/java/helpset/docs/debug/debug_pop.html

  • Committer: Bazaar Package Importer
  • Author(s): Marek Slama
  • Date: 2008-01-29 14:11:22 UTC
  • Revision ID: james.westby@ubuntu.com-20080129141122-fnzjbo11ntghxfu7
Tags: upstream-6.0.1
Import upstream version 6.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<!--
 
3
*     Copyright � 2007 Sun Microsystems, Inc. All rights reserved.
 
4
*     Use is subject to license terms.
 
5
*
 
6
-->
 
7
<html>
 
8
<head>
 
9
<title>Popping a Call from the Call Stack</title>
 
10
        <link rel="StyleSheet" href="nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css" type="text/css">
 
11
</head>
 
12
<body>
 
13
 
 
14
<h2>Popping a Call From the Call Stack</h2>
 
15
<p>
 
16
<small><a href="#seealso">See Also</a></small></p>
 
17
<p>
 
18
You can change the execution of your program so that the next statement to be executed is one of the 
 
19
calls made earlier on the stack.
 
20
In general, popping, or removing, a call from the call stack
 
21
does not undo any effects that the call caused.  For example,
 
22
if a call opened a database connection and then that
 
23
call is removed, the
 
24
database connection will remain open.
 
25
</p>
 
26
<ul class="note"><li>You can only pop a call if the program being debugged is paused.</ul>
 
27
 
 
28
<p><b>To pop the most recent call from the call stack:</b>
 
29
</p>
 
30
<ul>
 
31
  <li>From the main menu, choose Run  &gt; Stack &gt; Pop Topmost Call. 
 
32
    <p> The call is removed from the call stack. The program counter is moved to the 
 
33
      line before the instruction that made the removed call. If the source code 
 
34
      is available, the focus of the Source Editor is set to that line. When you 
 
35
      continue program execution, the call is repeated.</p>
 
36
 
 
37
  </li>
 
38
</ul>
 
39
 
 
40
<p><b>To pop multiple calls from the call stack:</b>
 
41
</p>
 
42
<ul>
 
43
  <li>In the Call Stack window, right-click the call that you want to remain at 
 
44
    the top of the call stack and choose Pop to Here.
 
45
    <p> All of the calls above the selected call are removed from the call stack. 
 
46
      The program counter is moved to the line before the instruction that made 
 
47
      the removed call. <!--question : what does made the removed call" mean?-->If the source code is available, the focus of the Source 
 
48
      Editor is set to that line. When you continue program execution, the call 
 
49
      is repeated.</p>  </li>
 
50
</ul>
 
51
 
 
52
<dl>
 
53
    <dt><a name="seealso">See Also</a></dt>
 
54
    <dd><a href="debug_callstack.html">Using the Call Stack </a></dd>
 
55
</dl>
 
56
 
 
57
<hr>
 
58
<small><a href="../credits.html">Legal Notices</a></small>
 
59
<table border="0" cellpadding="20">
 
60
<tr><td>&nbsp;</td></tr>
 
61
<tr><td>&nbsp;</td></tr>
 
62
<tr><td>&nbsp;</td></tr>
 
63
</table></body>
 
64
</html>