aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNick Roberts2005-10-06 20:14:24 +0000
committerNick Roberts2005-10-06 20:14:24 +0000
commite4481965c0d7dd85199c8fe4d7e5b2441239be1b (patch)
tree3700e98ea5bf6f6d7928f925ebfa2e6c9eb482b0
parent64015f0edd36073e565598ae01cf5a94445bba40 (diff)
downloademacs-e4481965c0d7dd85199c8fe4d7e5b2441239be1b.tar.gz
emacs-e4481965c0d7dd85199c8fe4d7e5b2441239be1b.zip
(GDB Graphical Interface): Add variables and
functions to indices. Be more precise.
-rw-r--r--man/building.texi51
1 files 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.
749@node GDB Graphical Interface 749@node GDB Graphical Interface
750@subsection GDB Graphical Interface 750@subsection GDB Graphical Interface
751 751
752@findex gdb-mouse-set-clear-breakpoint
753@findex gdb-mouse-toggle-breakpoint
752 By default, the command @code{gdb} starts GDB using a graphical 754 By default, the command @code{gdb} starts GDB using a graphical
753interface where you view and control the program's data using Emacs 755interface where you view and control the program's data using Emacs
754windows. You can still interact with GDB through the GUD buffer, but 756windows. 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
854when it is disabled. Text-only terminals correspondingly display 856when it is disabled. Text-only terminals correspondingly display
855a @samp{B} or @samp{b}. 857a @samp{B} or @samp{b}.
856 858
857@item @kbd{d} 859@item d
858@kindex d @r{(GDB breakpoints buffer)} 860@kindex d @r{(GDB breakpoints buffer)}
859@findex gdb-delete-breakpoint 861@findex gdb-delete-breakpoint
860Delete the breakpoint at the current line (@code{gdb-delete-breakpoint}). 862Delete 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
874of the nested subroutine calls (@dfn{stack frames}) now active in the 876of the nested subroutine calls (@dfn{stack frames}) now active in the
875program. @xref{Backtrace,,info stack, gdb, The GNU debugger}. 877program. @xref{Backtrace,,info stack, gdb, The GNU debugger}.
876 878
877The selected frame is displayed in reverse contrast. Move point to 879@findex gdb-frames-select
878any frame in the stack and type @key{RET} to select it (@code{gdb-frames-select}) 880The selected frame number is displayed in reverse contrast. Move
879and display the associated source in the source buffer. Alternatively, 881point to any frame in the stack and type @key{RET} to select it
880click @kbd{Mouse-2} to make the selected frame become the current one. 882(@code{gdb-frames-select}) and display the associated source in the
881If the locals buffer is displayed then its contents update to display 883source buffer. Alternatively, click @kbd{Mouse-2} on a frame to
882the variables that are local to the new frame. 884select it. If the locals buffer is displayed then its contents update
885to display the variables that are local to the new frame.
883 886
884@node Watch Expressions 887@node Watch Expressions
885@subsubsection Watch Expressions 888@subsubsection Watch Expressions
886@cindex Watching expressions in GDB 889@cindex Watching expressions in GDB
887 890
891@findex gud-watch
888If you want to see how a variable changes each time your program stops 892If you want to see how a variable changes each time your program stops
889then place the cursor over the variable name and click on the watch 893then place the cursor over the variable name and click on the watch
890icon in the tool bar (@code{gud-watch}). 894icon in the tool bar (@code{gud-watch}).
@@ -894,34 +898,37 @@ types, such as arrays, structures and unions are represented in a tree
894format. To expand or contract a complex data type, click @kbd{Mouse-2} 898format. To expand or contract a complex data type, click @kbd{Mouse-2}
895on the tag to the left of the expression. 899on the tag to the left of the expression.
896 900
897@kindex RET @r{(GDB speedbar)}
898@findex gdb-var-delete 901@findex gdb-var-delete
899With the cursor over the root expression of a complex data type, type 902With the cursor over the root expression of a complex data type, type
900@kbd{D} to delete it from the speedbar 903@kbd{D} to delete it from the speedbar
901(@code{gdb-var-delete}). 904(@code{gdb-var-delete}).
902 905
906@kindex RET @r{(GDB speedbar)}
903@findex gdb-edit-value 907@findex gdb-edit-value
904With the cursor over a simple data type or an element of a complex 908With the cursor over a simple data type or an element of a complex
905data type which holds a value, type @key{RET} or click @kbd{Mouse-2} to edit 909data type which holds a value, type @key{RET} or click @kbd{Mouse-2} to edit
906its value. A prompt for a new value appears in the mini-buffer 910its value. A prompt for a new value appears in the mini-buffer
907(@code{gdb-edit-value}). 911(@code{gdb-edit-value}).
908 912
913@vindex gdb-show-changed-values
909If you set the variable @code{gdb-show-changed-values} to 914If you set the variable @code{gdb-show-changed-values} to
910non-@code{nil} (the default value), then Emacs will use 915non-@code{nil} (the default value), Emacs will use
911font-lock-warning-face to display values that have recently changed in 916font-lock-warning-face to display values that have recently changed in
912the speedbar. 917the speedbar.
913 918
919@vindex gdb-use-colon-colon-notation
914If you set the variable @code{gdb-use-colon-colon-notation} to a 920If you set the variable @code{gdb-use-colon-colon-notation} to a
915non-@code{nil} value, then, in C, Emacs will use the 921non-@code{nil} value then, in C, Emacs will use the
916FUNCTION::VARIABLE format to display variables in the speedbar. 922@var{function}::@var{variable} format to display variables in the
917Since this does not work for variables defined in compound statements, 923speedbar. Since this does not work for variables defined in compound
918the default value is @code{nil}. 924statements, the default value is @code{nil}.
919 925
920@node Other GDB User Interface Buffers 926@node Other GDB User Interface Buffers
921@subsubsection Other Buffers 927@subsubsection Other Buffers
922 928
923@table @asis 929@table @asis
924@item Input/Output Buffer 930@item Input/Output Buffer
931@vindex gdb-use-inferior-io-buffer
925If the variable @code{gdb-use-inferior-io-buffer} is non-@code{nil}, 932If the variable @code{gdb-use-inferior-io-buffer} is non-@code{nil},
926the executable program that is being debugged takes its input and 933the executable program that is being debugged takes its input and
927displays its output here. Some of the commands from shell mode are 934displays 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
936separately to examine their values. @xref{Watch Expressions}. 943separately to examine their values. @xref{Watch Expressions}.
937 944
938@item Registers Buffer 945@item Registers Buffer
946@findex toggle-gdb-all-registers
939The registers buffer displays the values held by the registers 947The registers buffer displays the values held by the registers
940(@pxref{Registers,,, gdb, The GNU debugger}). Press @key{SPC} to 948(@pxref{Registers,,, gdb, The GNU debugger}). Press @key{SPC} to
941toggle the display of floating point registers. 949toggle the display of floating point registers
950(@code{toggle-gdb-all-registers}).
942 951
943@item Assembler Buffer 952@item Assembler Buffer
944The assembler buffer displays the current frame as machine code. An 953The assembler buffer displays the current frame as machine code. An
@@ -947,16 +956,16 @@ remove breakpoints as with the source buffer. Breakpoint icons also
947appear in the fringe or margin. 956appear in the fringe or margin.
948 957
949@item Threads Buffer 958@item Threads Buffer
950 959@findex gdb-threads-select
951The threads buffer displays a summary of all threads currently in your 960The threads buffer displays a summary of all threads currently in your
952program (@pxref{Threads,,, gdb, The GNU debugger}). Move point to 961program (@pxref{Threads,,, gdb, The GNU debugger}). Move point to any
953any thread in the list and press @key{RET} to make it become the 962thread in the list and press @key{RET} to select it
954current thread (@code{gdb-threads-select}) and display the associated 963(@code{gdb-threads-select}) and display the associated source in the
955source in the source buffer. Alternatively, click @kbd{Mouse-2} to 964source buffer. Alternatively, click @kbd{Mouse-2} on a thread to
956make the selected thread become the current one. 965select it. If the locals buffer is displayed then its contents update
966to display the variables that are local to the new thread.
957 967
958@item Memory Buffer 968@item Memory Buffer
959
960The memory buffer allows the user to examine sections of program 969The memory buffer allows the user to examine sections of program
961memory (@pxref{Memory,,, gdb, The GNU debugger}). Click @kbd{Mouse-1} 970memory (@pxref{Memory,,, gdb, The GNU debugger}). Click @kbd{Mouse-1}
962on the appropriate part of the header line to change the starting 971on the appropriate part of the header line to change the starting