Re: [RFA] New python module gdb.types

[Doug Evans <dje at google dot com>]

On Sat, Oct 9, 2010 at 2:14 AM, Eli Zaretskii <eliz@gnu.org> wrote:
>> Date: Fri, 8 Oct 2010 15:18:45 -0700
>> From: Doug Evans <dje@google.com>
>> Cc: gdb-patches@sourceware.org
>>
>> Return @var{type} with const and volatile qualifiers stripped,
>> and with typedefs and references converted to the underlying type.
>
> If the conversion of typedefs is recursive, then I think "to the
> underlying primitive data type" is more accurate.
>
> This takes care of typedefs. ?I'm still unclear regarding the
> "references" part. ?What does it mean? removing the "pointer to" part,
> like in "int *" -> "int"?
>
> I still maintain that examples go a long way towards explaining such
> abstract descriptions.
>
>> >> +@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.
>
> Well, you used it as a simple word, which makes it hard to guess to
> someone like me, for whom Python is a read-only language.
>
>> What if it said the following instead?
>>
>> Return a python dictionary made from @var{enum_type}.
>
> How about
>
> ?Return a Python @code{dictionary} type produced from @var{enum_type}.

How about this?

2010-10-13  Doug Evans  <dje@google.com>

        New python module gdb.types.
        * NEWS: Document it.
        * data-directory/Makefile.in (PYTHON_FILES): Add gdb/types.py.
        * python/lib/gdb/types.py: New file.

        testsuite/
        * lib/gdb-python.exp (gdb_check_python_config): New function.
        * gdb.python/Makefile.in (EXECUTABLES): Add lib-types.
        * gdb.python/lib-types.cc: New file.
        * gdb.python/lib-types.exp: New file.

        doc/
        * gdb.texinfo (Python): Add "Python modules".
        (Types in Python): Add reference to gdb.types section.
        (Python modules): New node.

Attachment: gdb-101013-types-module-3.patch.txt
Description: Text document