Re: [RFA] New python module gdb.types

[Doug Evans <dje@google.com>]

On Wed, Oct 6, 2010 at 2:04 PM, Eli Zaretskii <eliz@gnu.org> wrote:
>> +@item get_basic_type (@var{type})
>> +Return @var{type} with const and volatile qualifiers, typedefs,
>> +and references stripped away.
>
> This is quite cryptic.  I can understand what it means to remove
> const, volatile, etc. qualifiers (what about `static', btw?), but what
> does it mean to "strip" a typedef or a reference?  At the very least
> please give a few examples, if this cannot be explained easily.

static isn't an attribute of a type.

What if it said the following instead?

Return @var{type} with const and volatile qualifiers stripped,
and with typedefs and references converted to the underlying type.

>> +@item make_enum_dict (@var{enum_type})
>> +Return a dictionary made from @var{enum_type}.
>
> Same here: at the very least we should say what is a "dictionary" in
> this context.

The context is python and in the python context "dictionary" is quite
specific, it's a builtin type.

What if it said the following instead?

Return a python dictionary made from @var{enum_type}.