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