aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorVladimir Prus <vladimir@codesourcery.com>2009-09-19 10:46:20 +0000
committerVladimir Prus <vladimir@codesourcery.com>2009-09-19 10:46:20 +0000
commitb3372f91a14d2f43294ada7b9f42a6368a3975f8 (patch)
tree3dca5d9a261929ac5249ff2296f0badae6c204be
parentdaf3c9776f0c101dea753d0011ac5c7ca2caf665 (diff)
downloadgdb-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/ChangeLog5
-rw-r--r--gdb/doc/gdb.texinfo31
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