This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [RFA][Python] Change gdb.Value.address from a method to an attribute.
- From: Tom Tromey <tromey at redhat dot com>
- To: Eli Zaretskii <eliz at gnu dot org>
- Cc: Thiago Jung Bauermann <bauerman at br dot ibm dot com>, gdb-patches at sourceware dot org
- Date: Sun, 29 Mar 2009 09:41:48 -0600
- Subject: Re: [RFA][Python] Change gdb.Value.address from a method to an attribute.
- References: <orskllhfo3.fsf@oliva.athome.lsd.ic.unicamp.br> <20090310125945.GA4376@caradoc.them.org> <1236700079.11106.1.camel@localhost.localdomain> <orzlftfhu1.fsf@oliva.athome.lsd.ic.unicamp.br> <1236710732.11106.30.camel@localhost.localdomain> <m3hc1rluz1.fsf@fleche.redhat.com> <1237771863.25721.17.camel@localhost.localdomain> <m3bprs9lqg.fsf@fleche.redhat.com> <1238275138.8292.3.camel@localhost.localdomain> <ur60hkoml.fsf@gnu.org>
- Reply-to: Tom Tromey <tromey at redhat dot com>
>>>>> "Eli" == Eli Zaretskii <eliz@gnu.org> writes:
>> +@defmethod Value address
>> +If the @code{gdb.Value} object is addressable, this read-only attribute
>> +holds a @code{gdb.Value} object representing the address. Otherwise,
>> +this attribute holds @code{None}.
>> +@end defmethod
Eli> The two uses of `gdb.Value' so close to one another and meaning two
Eli> different things might confuse the reader.
Our readers are smarter than that.
But perhaps the first "the @code{}" can be changed to "this".
Eli> Is it really important to make the point that the address
Eli> attribute is itself a `gdb.Value'?
Yes. It is valuable for readers to know the possible types of method
return values and of attributes. This gives users an idea of what
operations can be done with the result.
Tom