From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 6729 invoked by alias); 20 Jun 2009 04:11:16 -0000 Received: (qmail 6720 invoked by uid 22791); 20 Jun 2009 04:11:15 -0000 X-SWARE-Spam-Status: No, hits=-0.9 required=5.0 tests=AWL,BAYES_00,J_CHICKENPOX_37,SARE_MSGID_LONG40,SPF_PASS X-Spam-Check-By: sourceware.org Received: from an-out-0708.google.com (HELO an-out-0708.google.com) (209.85.132.248) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sat, 20 Jun 2009 04:11:10 +0000 Received: by an-out-0708.google.com with SMTP id b38so1059809ana.3 for ; Fri, 19 Jun 2009 21:11:08 -0700 (PDT) MIME-Version: 1.0 Received: by 10.100.14.16 with SMTP id 16mr4820632ann.128.1245471067944; Fri, 19 Jun 2009 21:11:07 -0700 (PDT) Date: Sat, 20 Jun 2009 04:11:00 -0000 Message-ID: Subject: gdb.texinfo patch for -var-list-children (2) From: Chris Genly To: gdb-patches@sourceware.org Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit 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: 2009-06/txt/msg00525.txt.bz2 Description The gdb documentation for the MI command -var-list-children does not define the exp result for a child. Exp and other child results documented. Sorry I didn't document this with the last patch. But my understanding of MI commands is still increasing. Change log 2009-06-19 Chris Genly * doc/gdb.texinfo (GDB/MI Variable Objects): Document child definition in -var-list-children. Added exp result for child. Patch Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.600 diff -c -p -r1.600 gdb.texinfo *** gdb.texinfo 15 Jun 2009 12:11:36 -0000 1.600 --- gdb.texinfo 20 Jun 2009 04:07:54 -0000 *************** Returns the format used to display the v *** 23224,23229 **** --- 23224,23231 ---- @smallexample -var-info-num-children @var{name} @end smallexample + @anchor{-var-info-num-children} + Returns the number of children of a variable object @var{name}: *************** Returns the number of children of a vari *** 23242,23247 **** --- 23244,23250 ---- @end smallexample @anchor{-var-list-children} + Return a list of the children of the specified variable object and create variable objects for them, if they do not already exist. With a single argument or if @var{print-values} has a value for of 0 or *************** values; and if it is 2 or @code{--simple *** 23251,23266 **** value for simple data types and just the name for arrays, structures and unions. @subsubheading Example @smallexample (gdb) -var-list-children n ! ^done,numchild=@var{n},children=[@{name=@var{name}, numchild=@var{n},type=@var{type}@},@r{(repeats N times)}] (gdb) -var-list-children --all-values n ! ^done,numchild=@var{n},children=[@{name=@var{name}, numchild=@var{n},value=@var{value},type=@var{type}@},@r{(repeats N times)}] @end smallexample --- 23254,23290 ---- value for simple data types and just the name for arrays, structures and unions. + For each child the following results are returned: + + @table @var + + @item name + Name of the variable object created for this child. + + @item exp + The expression to be shown to the user by the front end to designate this child. + For example this may be the name of a structure member. + + For C/C++ structures there are several psuedo children returned to + designate access qualifiers. For these pseudo children @var{exp} is + @samp{public}, @samp{private}, or @samp{protected}. No type need be provided. + + @item numchild + Number of children this child has. + @item type + The type of the child. + @end table + @subsubheading Example @smallexample (gdb) -var-list-children n ! ^done,numchild=@var{n},children=[child=@{name=@var{name},exp=@var{exp}, numchild=@var{n},type=@var{type}@},@r{(repeats N times)}] (gdb) -var-list-children --all-values n ! ^done,numchild=@var{n},children=[child=@{name=@var{name},exp=@var{exp}, numchild=@var{n},value=@var{value},type=@var{type}@},@r{(repeats N times)}] @end smallexample