changeset 65881:6d77eb5953d0

(GDB Graphical Interface): Add variables and functions to indices. Be more precise.

--- a/man/building.texi	Thu Oct 06 20:13:38 2005 +0000
+++ b/man/building.texi	Thu Oct 06 20:14:24 2005 +0000
@@ -749,6 +749,8 @@
 @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 @@
 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 @@
 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 @@
 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 @@
 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 @@
 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