aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJoel Brobecker <brobecker@adacore.com>2013-12-23 11:15:42 +0400
committerJoel Brobecker <brobecker@adacore.com>2013-12-28 07:19:07 +0400
commit0809504b5eca5e73ad721919b6b13d941ffd0a30 (patch)
treec56723b5e2d0f31798f0bfb01c50679dfec89f9a
parentedef60002fc0c8d1bda6b5deb03c84d2733a32ba (diff)
downloadfsf-binutils-gdb-0809504b5eca5e73ad721919b6b13d941ffd0a30.zip
fsf-binutils-gdb-0809504b5eca5e73ad721919b6b13d941ffd0a30.tar.gz
fsf-binutils-gdb-0809504b5eca5e73ad721919b6b13d941ffd0a30.tar.bz2
Fix gdb.Field attributes documentation for enum types.
The following patch ... | commit 14e75d8ea4fe9ed4dbf292ae4a9745e33e2ff353 | Date: Wed Apr 18 06:46:47 2012 +0000 | | gdb/ | PR symtab/7259: | [...] ... discussed under ... [PATCH] Allow 64-bit enum values http://www.sourceware.org/ml/gdb-patches/2012-03/msg00772.html ... introduced a change in the gdb.Fields API without documenting it: | I took a separate approach from the one I took in: | | http://sourceware.org/ml/gdb-patches/2012-02/msg00403.html | | and removed the overloaded meaning of the bitpos location variable to | fix PR symtab/7259. In the following patch, I introduce a separate | field_location union member 'enumval' which can accept LONGEST and | hence expand enum values to 64-bit signed values. With this change, | bitpos now only is used for (non-negative) offsets into structures, | since the other overload of bitpos (range bounds) were already | separated into struct range_bound. This patch updates the documentation to reflect that change. gdb/doc/ChangeLog: * gdb.texinfo (Types In Python): Fix the documentation of attribute "bitpos" in class gdb.Field for enum types. Add documentation for attribute "enumval" in that same class.
-rw-r--r--gdb/doc/ChangeLog6
-rw-r--r--gdb/doc/gdb.texinfo11
2 files changed, 13 insertions, 4 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 5e446db..0df308d 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,5 +1,11 @@
2013-12-28 Joel Brobecker <brobecker@adacore.com>
+ * gdb.texinfo (Types In Python): Fix the documentation of
+ attribute "bitpos" in class gdb.Field for enum types. Add
+ documentation for attribute "enumval" in that same class.
+
+2013-12-28 Joel Brobecker <brobecker@adacore.com>
+
* gdb.texinfo (GDB/MI Support Commands): Change @table into
@ftable.
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 52a2694..3fa0999 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -24337,10 +24337,13 @@ into one of these categories, an empty sequence will be returned.
Each field is a @code{gdb.Field} object, with some pre-defined attributes:
@table @code
@item bitpos
-This attribute is not available for @code{static} fields (as in
-C@t{++} or Java). For non-@code{static} fields, the value is the bit
-position of the field. For @code{enum} fields, the value is the
-enumeration member's integer representation.
+This attribute is not available for @code{enum} or @code{static}
+(as in C@t{++} or Java) fields. The value is the bit position of
+the field.
+
+@item enumval
+This attribute is only available for @code{enum} fields, and its value
+is the enumeration member's integer representation.
@item name
The name of the field, or @code{None} for anonymous fields.