comparison man/building.texi @ 70056:7a7da1db58d4

(Watch Expressions): Update.
author Nick Roberts <nickrob@snap.net.nz>
date Mon, 17 Apr 2006 20:26:27 +0000
parents 601830ae280c
children 5d647f9d823b 72dea2ff0142
comparison
equal deleted inserted replaced
70055:a56d4dbf7c1e 70056:7a7da1db58d4
927 @node Watch Expressions 927 @node Watch Expressions
928 @subsubsection Watch Expressions 928 @subsubsection Watch Expressions
929 @cindex Watching expressions in GDB 929 @cindex Watching expressions in GDB
930 930
931 @findex gud-watch 931 @findex gud-watch
932 @kindex C-x C-a C-w @r{(GUD)}
932 If you want to see how a variable changes each time your program 933 If you want to see how a variable changes each time your program
933 stops, move point into the variable name and click on the watch icon 934 stops, move point into the variable name and click on the watch icon
934 in the tool bar (@code{gud-watch}). 935 in the tool bar (@code{gud-watch}) or type @kbd{C-x C-a C-w}. If you
936 specify a prefix argument, you can enter the variable name in the
937 minibuffer.
935 938
936 Each watch expression is displayed in the speedbar. Complex data 939 Each watch expression is displayed in the speedbar. Complex data
937 types, such as arrays, structures and unions are represented in a tree 940 types, such as arrays, structures and unions are represented in a tree
938 format. Leaves and simple data types show the name of the expression 941 format. Leaves and simple data types show the name of the expression
939 and its value and, when the speedbar frame is selected, display the 942 and its value and, when the speedbar frame is selected, display the
940 type as a tooltip. Higher levels show the name, type and address 943 type as a tooltip. Higher levels show the name, type and address
941 value for pointers and just the name and type otherwise. 944 value for pointers and just the name and type otherwise. Root expressions
945 also display the frame address as a tooltip to help identify the frame
946 in which they were defined.
942 947
943 To expand or contract a complex data type, click @kbd{Mouse-2} 948 To expand or contract a complex data type, click @kbd{Mouse-2}
944 on the tag to the left of the expression. 949 on the tag to the left of the expression.
945 950
951 @kindex D @r{(GDB speedbar)}
946 @findex gdb-var-delete 952 @findex gdb-var-delete
947 To delete a complex watch expression, move point to the root 953 To delete a complex watch expression, move point to the root
948 expression in the speedbar and type @kbd{D} (@code{gdb-var-delete}). 954 expression in the speedbar and type @kbd{D} (@code{gdb-var-delete}).
949 955
950 @kindex RET @r{(GDB speedbar)} 956 @kindex RET @r{(GDB speedbar)}
963 edit its value. 969 edit its value.
964 970
965 @vindex gdb-use-colon-colon-notation 971 @vindex gdb-use-colon-colon-notation
966 If the variable @code{gdb-use-colon-colon-notation} is 972 If the variable @code{gdb-use-colon-colon-notation} is
967 non-@code{nil}, Emacs uses the @samp{@var{function}::@var{variable}} 973 non-@code{nil}, Emacs uses the @samp{@var{function}::@var{variable}}
968 format to display variables in the speedbar. Since this does not work 974 format. This allows the user to display watch expressions which share
969 for variables defined in compound statements, the default value is 975 the same variable name. The default value is @code{nil}.
970 @code{nil}.
971 976
972 @vindex gdb-speedbar-auto-raise 977 @vindex gdb-speedbar-auto-raise
973 To automatically raise the speedbar every time the display of watch 978 To automatically raise the speedbar every time the display of watch
974 expressions updates, set @code{gdb-speedbar-auto-raise} to 979 expressions updates, set @code{gdb-speedbar-auto-raise} to
975 non-@code{nil}. This can be useful if you are debugging with a full 980 non-@code{nil}. This can be useful if you are debugging with a full