This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [RFA] New python module gdb.types
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}.