Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.442 diff -u -p -r1.442 gdb.texinfo --- gdb.texinfo 5 Nov 2007 11:32:31 -0000 1.442 +++ gdb.texinfo 9 Nov 2007 18:37:05 -0000 @@ -6250,6 +6250,41 @@ identical repetitions, instead of displa themselves. Setting the threshold to zero will cause all elements to be individually printed. The default threshold is 10. +@item set print frame-arguments @var{value} +This command allows to control how the value of arguments are printed +when the debugger prints a frame (@pxref{Frames}). The possible +values are: + +@table @code +@item all +The value of all arguments is printed. This is the default. + +@item scalars +Print the value of an argument only if it is a scalar. The value of more +complex arguments such as arrays, structures, unions, etc, is replaced +by @code{...}. Here is an example where only scalar arguments are shown: + +@smallexample +#1 0x08048361 in call_me (i=3, s=..., ss=0xbf8d508c, u=..., e=green) at frame-args.c:23 +@end smallexample + +@item none +None of the argument values are printed. Instead, the value of each argument +is replaced by @code{...}. In this case, the example above now becomes: + +@smallexample +#1 0x08048361 in call_me (i=..., s=..., ss=..., u=..., e=...) at frame-args.c:23 +@end smallexample +@end table + +By default, all argument values are always printed. But this command +can be useful to make a backtrace more readable, for instance, by +reducing the amount of information printed for each frame, particularly +when large objects would normally be printed. + +@item show print frame-arguments +Show how the value of arguments should be displayed when printing a frame. + @item show print repeats Display the current threshold for printing repeated identical elements.