Mercurial > emacs
changeset 52907:d1707faf8297
(Watch Expressions): Update section on data display
to reflect code changes (GDB Graphical Interface).
author | Nick Roberts <nickrob@snap.net.nz> |
---|---|
date | Tue, 21 Oct 2003 23:09:09 +0000 |
parents | ff56d93fae3f |
children | 1f8af3f14ee0 |
files | man/building.texi |
diffstat | 1 files changed, 15 insertions(+), 52 deletions(-) [+] |
line wrap: on
line diff
--- a/man/building.texi Tue Oct 21 23:08:11 2003 +0000 +++ b/man/building.texi Tue Oct 21 23:09:09 2003 +0000 @@ -631,8 +631,7 @@ @menu * Breakpoints Buffer:: A breakpoint control panel. * Stack Buffer:: Select a frame from the call stack. -* Data Display:: Display and update expressions in their own buffer. -* Display Buffer:: Control the displayed expressions. +* Watch Expressions:: Watch expressions and their values in the speedbar. * Other Buffers:: Input/output, locals, registers and assembler buffers. * Layout:: Control the number of displayed buffers. @end menu @@ -681,59 +680,23 @@ locals buffer is displayed then its contents update to display the variables that are local to the new frame. -@node Data Display -@subsubsection Data Display -@cindex displaying expressions in GDB +@node Watch Expressions +@subsubsection Watch Expressions +@cindex Watching expressions in GDB If you want to see how a variable changes each time your program stops -then place the cursor over the variable name and click on the display -icon in the toolbar (@code{gud-display}). - -Each displayed expression has its own frame on a graphical display and -its own buffer on a text-only terminal. Arrays and structures have -their own display formats. To display an array as a slice, at the top -of the display window, click @kbd{Mouse-2} on the array index that you -want to restrict and you will be prompted in the mini-buffer for a -start and a stop value. Click @kbd{Mouse-2} on a pointer to -dereference it in the same frame/buffer. Click @kbd{S-Mouse-2} there -to do the same thing but in a new frame/buffer. There are two special -commands for these buffers: - -@table @kbd -@item @kbd{v} -@kindex v @r{(GDB data buffer)} -@findex gdb-array-visualise -Visualise an array using the graph program from plotutils if this is -installed. This only works for one dimensional arrays -(@code{gdb-array-visualise}). +then place the cursor over the variable name and click on the watch +icon in the toolbar (@code{gud-watch}). -@item @kbd{q} -@kindex q @r{(GDB data buffer)} -@findex gdb-delete-expression -Delete the displayed expression and the associated frame -(@code{gdb-delete-expression}). -@end table - -@node Display Buffer -@subsubsection Display Buffer +Each watch expression is displayed in the speedbar. To expand or contract +an array or structure, click @kbd{Mouse-2} on the tag to the left of the +expression. -The display buffer shows the list of displayed expressions -(@pxref{Auto Display,,, gdb, The GNU debugger}). As with the -breakpoints, you can enable/disable or delete the displayed -expressions: - -@table @kbd -@item @key{SPC} -@kindex SPC @r{(GDB display buffer)} -@findex gdb-toggle-display -Enable/disable the display at the current line -(@code{gdb-toggle-display}). - -@item @kbd{d} -@kindex d @r{(GDB display buffer)} -@findex gdb-delete-display -Delete the display at the current line (@code{gdb-delete-display}). -@end table +@kindex RET @r{(GDB speedbar)} +@findex gdb-var-delete +With the cursor over a root expression i.e not an array index or +structure component, type @key{RET} or click @kbd{Mouse-2} to delete +it from the speedbar (@code{gdb-var-delete}). @node Other Buffers @subsubsection Other Buffers @@ -750,7 +713,7 @@ debugger}). Arrays and structures display their type only. You must display them -separately to examine their values. @ref{Data Display}. +separately to examine their values. @ref{Watch Expressions}. @item Registers Buffer The registers buffer displays the values held by the registers