From e4481965c0d7dd85199c8fe4d7e5b2441239be1b Mon Sep 17 00:00:00 2001 From: Nick Roberts Date: Thu, 6 Oct 2005 20:14:24 +0000 Subject: [PATCH] (GDB Graphical Interface): Add variables and functions to indices. Be more precise. --- man/building.texi | 51 ++++++++++++++++++++++++++++------------------- 1 file changed, 30 insertions(+), 21 deletions(-) diff --git a/man/building.texi b/man/building.texi index 30daa8def26..a9a3cc049c7 100644 --- a/man/building.texi +++ b/man/building.texi @@ -749,6 +749,8 @@ ignores any numeric argument. @node GDB Graphical Interface @subsection GDB Graphical Interface +@findex gdb-mouse-set-clear-breakpoint +@findex gdb-mouse-toggle-breakpoint By default, the command @code{gdb} starts GDB using a graphical interface where you view and control the program's data using Emacs windows. You can still interact with GDB through the GUD buffer, but @@ -854,7 +856,7 @@ relevant line. This is red when the breakpoint is enabled and grey when it is disabled. Text-only terminals correspondingly display a @samp{B} or @samp{b}. -@item @kbd{d} +@item d @kindex d @r{(GDB breakpoints buffer)} @findex gdb-delete-breakpoint Delete the breakpoint at the current line (@code{gdb-delete-breakpoint}). @@ -874,17 +876,19 @@ The stack buffer displays a @dfn{call stack}, with one line for each of the nested subroutine calls (@dfn{stack frames}) now active in the program. @xref{Backtrace,,info stack, gdb, The GNU debugger}. -The selected frame is displayed in reverse contrast. Move point to -any frame in the stack and type @key{RET} to select it (@code{gdb-frames-select}) -and display the associated source in the source buffer. Alternatively, -click @kbd{Mouse-2} to make the selected frame become the current one. -If the locals buffer is displayed then its contents update to display -the variables that are local to the new frame. +@findex gdb-frames-select +The selected frame number is displayed in reverse contrast. Move +point to any frame in the stack and type @key{RET} to select it +(@code{gdb-frames-select}) and display the associated source in the +source buffer. Alternatively, click @kbd{Mouse-2} on a frame to +select it. If the locals buffer is displayed then its contents update +to display the variables that are local to the new frame. @node Watch Expressions @subsubsection Watch Expressions @cindex Watching expressions in GDB +@findex gud-watch 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 watch icon in the tool bar (@code{gud-watch}). @@ -894,34 +898,37 @@ types, such as arrays, structures and unions are represented in a tree format. To expand or contract a complex data type, click @kbd{Mouse-2} on the tag to the left of the expression. -@kindex RET @r{(GDB speedbar)} @findex gdb-var-delete With the cursor over the root expression of a complex data type, type @kbd{D} to delete it from the speedbar (@code{gdb-var-delete}). +@kindex RET @r{(GDB speedbar)} @findex gdb-edit-value With the cursor over a simple data type or an element of a complex data type which holds a value, type @key{RET} or click @kbd{Mouse-2} to edit its value. A prompt for a new value appears in the mini-buffer (@code{gdb-edit-value}). +@vindex gdb-show-changed-values If you set the variable @code{gdb-show-changed-values} to -non-@code{nil} (the default value), then Emacs will use +non-@code{nil} (the default value), Emacs will use font-lock-warning-face to display values that have recently changed in the speedbar. +@vindex gdb-use-colon-colon-notation If you set the variable @code{gdb-use-colon-colon-notation} to a -non-@code{nil} value, then, in C, Emacs will use the -FUNCTION::VARIABLE format to display variables in the speedbar. -Since this does not work for variables defined in compound statements, -the default value is @code{nil}. +non-@code{nil} value then, in C, Emacs will use the +@var{function}::@var{variable} format to display variables in the +speedbar. Since this does not work for variables defined in compound +statements, the default value is @code{nil}. @node Other GDB User Interface Buffers @subsubsection Other Buffers @table @asis @item Input/Output Buffer +@vindex gdb-use-inferior-io-buffer If the variable @code{gdb-use-inferior-io-buffer} is non-@code{nil}, the executable program that is being debugged takes its input and displays its output here. Some of the commands from shell mode are @@ -936,9 +943,11 @@ Arrays and structures display their type only. You must display them separately to examine their values. @xref{Watch Expressions}. @item Registers Buffer +@findex toggle-gdb-all-registers The registers buffer displays the values held by the registers (@pxref{Registers,,, gdb, The GNU debugger}). Press @key{SPC} to -toggle the display of floating point registers. +toggle the display of floating point registers +(@code{toggle-gdb-all-registers}). @item Assembler Buffer The assembler buffer displays the current frame as machine code. An @@ -947,16 +956,16 @@ remove breakpoints as with the source buffer. Breakpoint icons also appear in the fringe or margin. @item Threads Buffer - +@findex gdb-threads-select The threads buffer displays a summary of all threads currently in your -program (@pxref{Threads,,, gdb, The GNU debugger}). Move point to -any thread in the list and press @key{RET} to make it become the -current thread (@code{gdb-threads-select}) and display the associated -source in the source buffer. Alternatively, click @kbd{Mouse-2} to -make the selected thread become the current one. +program (@pxref{Threads,,, gdb, The GNU debugger}). Move point to any +thread in the list and press @key{RET} to select it +(@code{gdb-threads-select}) and display the associated source in the +source buffer. Alternatively, click @kbd{Mouse-2} on a thread to +select it. If the locals buffer is displayed then its contents update +to display the variables that are local to the new thread. @item Memory Buffer - The memory buffer allows the user to examine sections of program memory (@pxref{Memory,,, gdb, The GNU debugger}). Click @kbd{Mouse-1} on the appropriate part of the header line to change the starting -- 2.39.2