Re: [RFA] new command: maintenance print target-stack

[Joel Brobecker <brobecker@adacore.com>]

[-- Attachment #1: Type: text/plain, Size: 611 bytes --]

> 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

[-- Attachment #2: doco.diff --]
[-- Type: text/plain, Size: 1130 bytes --]

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}