diff options
author | Vladimir Prus <vladimir@codesourcery.com> | 2009-09-19 10:46:20 +0000 |
---|---|---|
committer | Vladimir Prus <vladimir@codesourcery.com> | 2009-09-19 10:46:20 +0000 |
commit | b3372f91a14d2f43294ada7b9f42a6368a3975f8 (patch) | |
tree | 3dca5d9a261929ac5249ff2296f0badae6c204be | |
parent | daf3c9776f0c101dea753d0011ac5c7ca2caf665 (diff) | |
download | gdb-b3372f91a14d2f43294ada7b9f42a6368a3975f8.zip gdb-b3372f91a14d2f43294ada7b9f42a6368a3975f8.tar.gz gdb-b3372f91a14d2f43294ada7b9f42a6368a3975f8.tar.bz2 |
* gdb.texinfo (GDB/MI Stack Manipulation): Document
-stack-list-variables.
-rw-r--r-- | gdb/doc/ChangeLog | 5 | ||||
-rw-r--r-- | gdb/doc/gdb.texinfo | 31 |
2 files changed, 36 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 07c5a04..50f0b25 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2009-09-19 Vladimir Prus <vladimir@codesourcery.com> + + * gdb.texinfo (GDB/MI Stack Manipulation): Document + -stack-list-variables. + 2009-09-18 Tom Tromey <tromey@redhat.com> * gdb.texinfo (GDB/MI Variable Objects): -enable-pretty-printing diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index a627ce4..719cce5 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -23130,6 +23130,9 @@ The @var{show-values} argument must have a value of 0 or 1. A value of 0 means that only the names of the arguments are listed, a value of 1 means that both names and values of the arguments are printed. +Use of this command to obtain arguments in a single frame is +deprecated in favor of the @samp{-stack-list-variables} command. + @subsubheading @value{GDBN} Command @value{GDBN} does not have an equivalent command. @code{gdbtk} has a @@ -23314,6 +23317,9 @@ display the value of simple data types and create variable objects for other data types when the user wishes to explore their values in more detail. +This command is deprecated in favor of the +@samp{-stack-list-variables} command. + @subsubheading @value{GDBN} Command @samp{info locals} in @value{GDBN}, @samp{gdb_get_locals} in @code{gdbtk}. @@ -23334,6 +23340,31 @@ more detail. (gdb) @end smallexample +@subheading The @code{-stack-list-variables} Command +@findex -stack-list-variables + +@subsubheading Synopsis + +@smallexample + -stack-list-variables @var{print-values} +@end smallexample + +Display the names of local variables and function arguments for the selected frame. If +@var{print-values} is 0 or @code{--no-values}, print only the names of +the variables; if it is 1 or @code{--all-values}, print also their +values; and if it is 2 or @code{--simple-values}, print the name, +type and value for simple data types and the name and type for arrays, +structures and unions. + +@subsubheading Example + +@smallexample +(gdb) +-stack-list-variables --thread 1 --frame 0 --all-values +^done,variables=[{name="x",value="11"},{name="s",value="{a = 1, b = 2}"}] +(gdb) +@end smallexample + @subheading The @code{-stack-select-frame} Command @findex -stack-select-frame |