Re: [RFA] Document fixed/floating variable objects and thread-id.

Vladimir Prus
2008-04-09T11:59:42Z

Eli Zaretskii wrote:

>> From: Vladimir Prus <vladimir@codesourcery.com>
>> Date: Fri, 4 Apr 2008 13:20:00 +0400
>>
>>
>> This patch adds some more docs about variable objects.
>
> Thanks, adding documentation is always welcome.
>
>> * gdb/doc/gdb.texinfo (gdb/mi Variable object): Document
>> fixed and floating variable objects, and clarify that
>> a variable object can also be found to a thread. Update
>> -var-create example.
>
> Some comments and suggestions:
>
>> +Variable objects can be either ``fixed'' or ``floating''. For the
>
> Texinfo has a special markup for introducing new terminology: @dfn.
> So please use @dfn{fixed} and @dfn{floating}, as it looks better in
> print.
>
> Also, there's only one blank after the end of the sentence here;
> please use two.
>
>> +fixed variable object, the expression is parsed when the variable
>> +object is created, including associating indentifiers to specific
>> +variables. The meaning of expression never changes. A floating
>> +variable object has its expression reparsed each time the variable
>> +object is updated. In particular, the meaning of identifiers can
>> +change every time.
>
> Instead of ``meaning'' here, isn't it better to say ``value''?

Identifier does not have a value. Think of 'i' -- it's just a name.
It is then associated to a specific variable, which variable has value.
What I mean is that association between identifiers to variables can
change for floating variable objects. Of course, the values can also
change, but values can change even for fixed variable objects.

What's the best way to express this?

- Volodya