GDB MI Reverse Commands added [2 of 3]

["Jakob Engblom" <jakob at virtutech dot com>]

Here are the documentation updates. 

Changelog: "Added documentation of gdb-MI reverse debugging commands"

cvs diff: Diffing gdb/doc
Index: gdb/doc/gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.615
diff -c -p -r1.615 gdb.texinfo
*** gdb/doc/gdb.texinfo 6 Aug 2009 23:08:16 -0000?????? 1.615
--- gdb/doc/gdb.texinfo 25 Aug 2009 14:40:16 -0000
*************** other cases.
*** 22394,22413 ****
? @subsubheading Synopsis

? @smallexample
!? -exec-continue [--all|--thread-group N]
? @end smallexample

? Resumes the execution of the inferior program until a breakpoint is
! encountered, or until the inferior exits.? In all-stop mode
! (@pxref{All-Stop Mode}), may resume only one thread, or all threads,
! depending on the value of the @samp{scheduler-locking} variable.? In
! non-stop mode (@pxref{Non-Stop Mode}), if the @samp{--all} is not
! specified, only the thread specified with the @samp{--thread} option
! (or current thread, if no @samp{--thread} is provided) is resumed.? If
! @samp{--all} is specified, all threads will be resumed.? The
! @samp{--all} option is ignored in all-stop mode.? If the
! @samp{--thread-group} options is specified, then all threads in that
! thread group are resumed.

? @subsubheading @value{GDBN} Command

--- 22394,22415 ----
? @subsubheading Synopsis

? @smallexample
!? -exec-continue [--reverse] [--all|--thread-group N]
? @end smallexample

? Resumes the execution of the inferior program until a breakpoint is
! encountered, or until the inferior exits. If the @samp{--reverse}
! option is specified, resumes the reverse execution of the inferior
! program until a breakpoint is encountered, or until the inferior
! exits.? In all-stop mode (@pxref{All-Stop Mode}), may resume only one
! thread, or all threads, depending on the value of the
! @samp{scheduler-locking} variable.? In non-stop mode (@pxref{Non-Stop
! Mode}), if the @samp{--all} is not specified, only the thread
! specified with the @samp{--thread} option (or current thread, if no
! @samp{--thread} is provided) is resumed.? If @samp{--all} is
! specified, all threads will be resumed.? The @samp{--all} option is
! ignored in all-stop mode.? If the @samp{--thread-group} options is
! specified, then all threads in that thread group are resumed.

? @subsubheading @value{GDBN} Command

*************** line="13"@}
*** 22433,22443 ****
? @subsubheading Synopsis

? @smallexample
!? -exec-finish
? @end smallexample

? Resumes the execution of the inferior program until the current
? function is exited.? Displays the results returned by the function.

? @subsubheading @value{GDBN} Command

--- 22435,22448 ----
? @subsubheading Synopsis

? @smallexample
!? -exec-finish [--reverse]
? @end smallexample

? Resumes the execution of the inferior program until the current
? function is exited.? Displays the results returned by the function.
+ If the @samp{--reverse} option is specified, resumes the reverse
+ execution of the inferior program until the point where current
+ function was called.

? @subsubheading @value{GDBN} Command

*************** The corresponding @value{GDBN} command i
*** 22556,22567 ****
? @subsubheading Synopsis

? @smallexample
!? -exec-next
? @end smallexample

? Resumes execution of the inferior program, stopping when the beginning
? of the next source line is reached.

? @subsubheading @value{GDBN} Command

? The corresponding @value{GDBN} command is @samp{next}.
--- 22561,22578 ----
? @subsubheading Synopsis

? @smallexample
!? -exec-next [--reverse]
? @end smallexample

? Resumes execution of the inferior program, stopping when the beginning
? of the next source line is reached.

+ If the @samp{--reverse} option is specified, resumes reverse execution
+ of the inferior program, stopping at the beginning of the previous
+ source line. Starting from the first line of a function, the command
+ will take you back to the caller of that function, before the function
+ was called.
+
? @subsubheading @value{GDBN} Command

? The corresponding @value{GDBN} command is @samp{next}.
*************** The corresponding @value{GDBN} command i
*** 22583,22589 ****
? @subsubheading Synopsis

? @smallexample
!? -exec-next-instruction
? @end smallexample

? Executes one machine instruction.? If the instruction is a function
--- 22594,22600 ----
? @subsubheading Synopsis

? @smallexample
!? -exec-next-instruction [--reverse]
? @end smallexample

? Executes one machine instruction.? If the instruction is a function
*************** call, continues until the function retur
*** 22591,22596 ****
--- 22602,22613 ----
? instruction in the middle of a source line, the address will be
? printed as well.

+ If the @samp{--reverse} option is specified, resumes reverse execution
+ of the inferior program, stopping at the previous instruction. If the
+ previously executed instruction was a return from another instruction,
+ it will continue to execute in reverse until the call to that function
+ (from the current stack frame) is reached.
+
? @subsubheading @value{GDBN} Command

? The corresponding @value{GDBN} command is @samp{nexti}.
*************** signal-meaning="Interrupt"
*** 22733,22745 ****
? @subsubheading Synopsis

? @smallexample
!? -exec-step
? @end smallexample

? Resumes execution of the inferior program, stopping when the beginning
? of the next source line is reached, if the next source line is not a
? function call.? If it is, stop at the first instruction of the called
! function.

? @subsubheading @value{GDBN} Command

--- 22750,22764 ----
? @subsubheading Synopsis

? @smallexample
!? -exec-step [--reverse]
? @end smallexample

? Resumes execution of the inferior program, stopping when the beginning
? of the next source line is reached, if the next source line is not a
? function call.? If it is, stop at the first instruction of the called
! function. If the @samp{--reverse} option is specified, resumes reverse
! execution of the inferior program, stopping at the beginning of the
! previously executed source line.

? @subsubheading @value{GDBN} Command

*************** Regular stepping:
*** 22777,22786 ****
? @subsubheading Synopsis

? @smallexample
!? -exec-step-instruction
? @end smallexample

! Resumes the inferior which executes one machine instruction.? The
? output, once @value{GDBN} has stopped, will vary depending on whether
? we have stopped in the middle of a source line or not.? In the former
? case, the address at which the program stopped will be printed as
--- 22796,22807 ----
? @subsubheading Synopsis

? @smallexample
!? -exec-step-instruction [--reverse]
? @end smallexample

! Resumes the inferior which executes one machine instruction. If the
! @samp{--reverse} option is specified, resumes reverse execution of the
! inferior program, stopping at the previously executed instruction. The
? output, once @value{GDBN} has stopped, will vary depending on whether
? we have stopped in the middle of a source line or not.? In the former
? case, the address at which the program stopped will be printed as




Best regards,

/jakob

_______________________________________________________

Jakob Engblom, PhD, Technical Marketing Manager

Virtutech?????????????????? Direct: +46 8 690 07 47???
Drottningholmsvägen 22????? Mobile: +46 709 242 646??
11243 Stockholm???????????? Web:??? www.virtutech.com?
Sweden
________________________________________________________
?