[Emacs-diffs] Changes to emacs/man/building.texi

[Nick Roberts]

Index: emacs/man/building.texi
diff -c emacs/man/building.texi:1.70 emacs/man/building.texi:1.71
*** emacs/man/building.texi:1.70        Thu Aug 18 02:48:50 2005
--- emacs/man/building.texi     Thu Oct  6 20:14:24 2005
***************
*** 749,754 ****
--- 749,756 ----
  @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,860 ****
  when it is disabled.  Text-only terminals correspondingly display
  a @samp{B} or @samp{b}.
  
! @item @kbd{d}
  @kindex d @r{(GDB breakpoints buffer)}
  @findex gdb-delete-breakpoint
  Delete the breakpoint at the current line (@code{gdb-delete-breakpoint}).
--- 856,862 ----
  when it is disabled.  Text-only terminals correspondingly display
  a @samp{B} or @samp{b}.
  
! @item d
  @kindex d @r{(GDB breakpoints buffer)}
  @findex gdb-delete-breakpoint
  Delete the breakpoint at the current line (@code{gdb-delete-breakpoint}).
***************
*** 874,890 ****
  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.
  
  @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 watch
  icon in the tool bar (@code{gud-watch}).
--- 876,894 ----
  of the nested subroutine calls (@dfn{stack frames}) now active in the
  program.  @xref{Backtrace,,info stack, gdb, The GNU debugger}.
  
! @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,927 ****
  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}).
  
  @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}).
  
  If you set the variable @code{gdb-show-changed-values} to
! address@hidden (the default value), then Emacs will use
  font-lock-warning-face to display values that have recently changed in
  the speedbar.
  
  If you set the variable @code{gdb-use-colon-colon-notation} to a
! address@hidden 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}.
  
  @node Other GDB User Interface Buffers
  @subsubsection Other Buffers
  
  @table @asis
  @item Input/Output Buffer
  If the variable @code{gdb-use-inferior-io-buffer} is address@hidden,
  the executable program that is being debugged takes its input and
  displays its output here.  Some of the commands from shell mode are
--- 898,934 ----
  format.  To expand or contract a complex data type, click @kbd{Mouse-2}
  on the tag to the left of the expression.
  
  @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
! address@hidden (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
! address@hidden 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 address@hidden,
  the executable program that is being debugged takes its input and
  displays its output here.  Some of the commands from shell mode are
***************
*** 936,944 ****
  separately to examine their values.  @xref{Watch Expressions}.
  
  @item Registers Buffer
  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.
  
  @item Assembler Buffer
  The assembler buffer displays the current frame as machine code.  An
--- 943,953 ----
  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
! (@code{toggle-gdb-all-registers}).
  
  @item Assembler Buffer
  The assembler buffer displays the current frame as machine code.  An
***************
*** 947,962 ****
  appear in the fringe or margin.
  
  @item Threads Buffer
! 
  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.
  
  @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
--- 956,971 ----
  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 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