diff options
author | Elena Zannoni <ezannoni@kwikemart.cygnus.com> | 2003-01-15 14:31:59 +0000 |
---|---|---|
committer | Elena Zannoni <ezannoni@kwikemart.cygnus.com> | 2003-01-15 14:31:59 +0000 |
commit | c60eb6f167ea93741f61354c1f4fa3541372cd51 (patch) | |
tree | 31cf0bf63865cd62e036faa682d5bc160b6b19eb /gdb | |
parent | 82025e130718cfcebc7ca6c9d72c8fc4ee409651 (diff) | |
download | gdb-c60eb6f167ea93741f61354c1f4fa3541372cd51.zip gdb-c60eb6f167ea93741f61354c1f4fa3541372cd51.tar.gz gdb-c60eb6f167ea93741f61354c1f4fa3541372cd51.tar.bz2 |
2003-01-15 Elena Zannoni <ezannoni@redhat.com>
* gdb.texinfo (Continuing and Stepping): Add new command
'advance'. Clarify behavior of 'until'.
Diffstat (limited to 'gdb')
-rw-r--r-- | gdb/doc/ChangeLog | 5 | ||||
-rw-r--r-- | gdb/doc/gdb.texinfo | 31 |
2 files changed, 34 insertions, 2 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 6aacaab..3d1b173 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2003-01-15 Elena Zannoni <ezannoni@redhat.com> + + * gdb.texinfo (Continuing and Stepping): Add new command + 'advance'. Clarify behavior of 'until'. + 2003-01-13 Daniel Jacobowitz <drow@mvista.com> * gdb.texinfo (Files): Document solib-absolute-prefix and diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index bb67bc3..b951ae2 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -3462,8 +3462,35 @@ argument. Continue running your program until either the specified location is reached, or the current stack frame returns. @var{location} is any of the forms of argument acceptable to @code{break} (@pxref{Set Breaks, -,Setting breakpoints}). This form of the command uses breakpoints, -and hence is quicker than @code{until} without an argument. +,Setting breakpoints}). This form of the command uses breakpoints, and +hence is quicker than @code{until} without an argument. The specified +location is actually reached only if it is in the current frame. This +implies that @code{until} can be used to skip over recursive function +invocations. For instance in the code below, if the current location is +line @code{96}, issuing @code{until 99} will execute the program up to +line @code{99} in the same invocation of factorial, i.e. after the inner +invocations have returned. + +@smallexample +94 int factorial (int value) +95 @{ +96 if (value > 1) @{ +97 value *= factorial (value - 1); +98 @} +99 return (value); +100 @} +@end smallexample + + +@kindex advance @var{location} +@itemx advance @var{location} +Continue running the program up to the given location. An argument is +required, anything of the same form as arguments for the @code{break} +command. Execution will also stop upon exit from the current stack +frame. This command is similar to @code{until}, but @code{advance} will +not skip over recursive function calls, and the target location doesn't +have to be in the same frame as the current one. + @kindex stepi @kindex si @r{(@code{stepi})} |