This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [PATCH 12/12] NEWS and Doc on --available-children-only
- From: Eli Zaretskii <eliz at gnu dot org>
- To: Yao Qi <yao at codesourcery dot com>
- Cc: gdb-patches at sourceware dot org
- Date: Tue, 18 Feb 2014 07:11:16 +0200
- Subject: Re: [PATCH 12/12] NEWS and Doc on --available-children-only
- Authentication-results: sourceware.org; auth=none
- References: <1392367471-13527-1-git-send-email-yao at codesourcery dot com> <1392367471-13527-13-git-send-email-yao at codesourcery dot com> <83ha82c9rf dot fsf at gnu dot org> <5301D9F4 dot 5010306 at codesourcery dot com> <83zjlp93vz dot fsf at gnu dot org> <5302BE78 dot 10400 at codesourcery dot com>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> Date: Tue, 18 Feb 2014 09:59:20 +0800
> From: Yao Qi <yao@codesourcery.com>
> CC: <gdb-patches@sourceware.org>
>
> 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?