From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 4384 invoked by alias); 9 Nov 2007 19:13:37 -0000 Received: (qmail 4371 invoked by uid 22791); 9 Nov 2007 19:13:36 -0000 X-Spam-Check-By: sourceware.org Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15) by sourceware.org (qpsmtpd/0.31) with ESMTP; Fri, 09 Nov 2007 19:13:34 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id B4FDC2AC05E for ; Fri, 9 Nov 2007 14:13:32 -0500 (EST) Received: from rock.gnat.com ([127.0.0.1]) by localhost (rock.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id TPdx23pBytuf for ; Fri, 9 Nov 2007 14:13:32 -0500 (EST) Received: from joel.gnat.com (localhost.localdomain [127.0.0.1]) by rock.gnat.com (Postfix) with ESMTP id 326722AB977 for ; Fri, 9 Nov 2007 14:13:30 -0500 (EST) Received: by joel.gnat.com (Postfix, from userid 1000) id E0B0AE7ACA; Fri, 9 Nov 2007 11:13:00 -0800 (PST) Date: Fri, 09 Nov 2007 19:13:00 -0000 From: Joel Brobecker To: gdb-patches@sourceware.org Subject: [RFA/doco] Document "set/show print frame-arguments" Message-ID: <20071109191300.GC4339@adacore.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="WYTEVAkct0FjGQmd" Content-Disposition: inline User-Agent: Mutt/1.4.2.2i Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2007-11/txt/msg00205.txt.bz2 --WYTEVAkct0FjGQmd Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-length: 371 Hello, Here is the documentation related to the "set/show print frame-arguments" that I recently added. 2007-11-09 Joel Brobecker * gdb.texinfo (Print Settings): Add documentation for "set/show print frame-arguments". I am debating whether the last paragraphe should be merged with the first one, or not... Thanks, -- Joel --WYTEVAkct0FjGQmd Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="args-doc.diff" Content-length: 1890 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. --WYTEVAkct0FjGQmd--