[RFA] new command: maintenance print target-stack
Joel Brobecker
brobecker@adacore.com
Fri Jan 26 22:04:00 GMT 2007
> This is okay, except that the term "target stack", and what is pushed
> onto it, is not explained anywhere in the manual, not even in
> gdbint.texinfo. Can you add a sentence or two saying what it is?
>
> Also, the first usage of "target stack" should be in @dfn, which is
> our way of saying that this is a new term.
Good points. I was lucky to find something in target.h, so I shamelessly
copied it. How does this look?
2007-01-26 Joel Brobecker <brobecker@adacore.com>
* gdb.texinfo (Maintenance Commands): Add documentation for
the new "maint print target-stack" command.
--
Joel
-------------- next part --------------
Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.379
diff -u -p -r1.379 gdb.texinfo
--- gdb.texinfo 20 Jan 2007 16:51:55 -0000 1.379
+++ gdb.texinfo 26 Jan 2007 21:55:27 -0000
@@ -22667,6 +22667,19 @@ average, and median entry size, total me
savings, and various measures of the hash table size and chain
lengths.
+@kindex maint print target-stack
+@cindex target stack description
+@item maint print target-stack
+A @dfn{target} is an interface between the debugger and a particular
+kind of file or process. Targets can be stacked in @dfn{strata},
+so that more than one target can potentially respond to a request.
+In particular, memory accesses will walk down the stack of targets
+until they find a target that is interested in handling that particular
+address.
+
+This command prints a short description of each layer that was pushed on
+the @dfn{target stack}, starting from the top layer down to the bottom one.
+
@kindex maint print type
@cindex type chain of a data type
@item maint print type @var{expr}
More information about the Gdb-patches
mailing list