From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 24145 invoked by alias); 18 Feb 2014 05:11:17 -0000 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 Received: (qmail 24134 invoked by uid 89); 18 Feb 2014 05:11:16 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.9 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL autolearn=no version=3.3.2 X-HELO: mtaout23.012.net.il Received: from mtaout23.012.net.il (HELO mtaout23.012.net.il) (80.179.55.175) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 18 Feb 2014 05:11:12 +0000 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0N1600J00E5O7V00@a-mtaout23.012.net.il> for gdb-patches@sourceware.org; Tue, 18 Feb 2014 07:11:09 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N1600J64EEL8E00@a-mtaout23.012.net.il>; Tue, 18 Feb 2014 07:11:09 +0200 (IST) Date: Tue, 18 Feb 2014 05:11:00 -0000 From: Eli Zaretskii Subject: Re: [PATCH 12/12] NEWS and Doc on --available-children-only In-reply-to: <5302BE78.10400@codesourcery.com> To: Yao Qi Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83ppml6m4r.fsf@gnu.org> References: <1392367471-13527-1-git-send-email-yao@codesourcery.com> <1392367471-13527-13-git-send-email-yao@codesourcery.com> <83ha82c9rf.fsf@gnu.org> <5301D9F4.5010306@codesourcery.com> <83zjlp93vz.fsf@gnu.org> <5302BE78.10400@codesourcery.com> X-IsSubscribed: yes X-SW-Source: 2014-02/txt/msg00558.txt.bz2 > Date: Tue, 18 Feb 2014 09:59:20 +0800 > From: Yao Qi > CC: > > When GDB reads from trace frames, if the variables are collected and > saved in trace frames, GDB is able to show the valid values of these > variables. We call "values of these variables are available". OTOH, > if the variables are not collected, "their values are unavailable". > > For example, in a traceframe, field a is collected but field b is not. > As a result, value of field a is available, and value of field b is > unavailable. > > struct foo > { > int a; /* Collected */ > int b; /* Uncollected */ > }; > > Going to MI/varobj world, everything is structured as a tree, and each > tree node is about certain value. foo.a and foo.b are the children of > foo in MI/varobj, so foo.a is an available child of foo, but foo.b > isn't. > > The concept of available and unavailable can be illustrated by GDB > accessing trace frames, but the concept itself is quite independent and > can be applied to other situations. OK, thanks. I think I understand. I suggest, instead of this: If the @samp{--available-children-only} option is specified, then only value available or collected children of the varobj are considered. to say this: If the @samp{--available-children-only} option is specified, then @value(GDBN) considers only those children of the varobj whose values were collected. And in general, use "collected values" and "children whose values were collected" or "children with collected values" in other places. Does this correctly capture your intent?