gdb.texinfo (Values From Inferior): Clarify that
authorEli Zaretskii <eliz@gnu.org>
Wed, 22 Sep 2010 09:13:31 +0000 (09:13 +0000)
committerEli Zaretskii <eliz@gnu.org>
Wed, 22 Sep 2010 09:13:31 +0000 (09:13 +0000)
 value.dynamic_type works only in C++ programs with RTTI.

gdb/doc/ChangeLog
gdb/doc/gdb.texinfo

index 579b7c56b5db470774fcdd6731edf412061e9f44..b3ca8af741f9c1d1970f722cbb2e604ac53a7b7a 100644 (file)
@@ -1,3 +1,8 @@
+2010-09-22  Eli Zaretskii  <eliz@gnu.org>
+
+       * gdb.texinfo (Values From Inferior): Clarify that
+       value.dynamic_type works only in C++ programs with RTTI.
+
 2010-09-15  Paul Bolle  <pebolle@tiscali.nl>
 
        * gdb.texinfo (Character Sets): Correctly reference host-charset
index b59ce0d2f285b46c680b082ea049e7876a911cce..e5be50945aaa2b24da840718ebcbd2562b49163e 100644 (file)
@@ -20762,12 +20762,18 @@ The type of this @code{gdb.Value}.  The value of this attribute is a
 
 @defivar Value dynamic_type
 The dynamic type of this @code{gdb.Value}.  This uses C@t{++} run-time
-type information to determine the dynamic type of the value.  If this
-value is of class type, it will return the class in which the value is
-embedded, if any.  If this value is of pointer or reference to a class
-type, it will compute the dynamic type of the referenced object, and
-return a pointer or reference to that type, respectively.  In all
-other cases, it will return the value's static type.
+type information (@acronym{RTTI}) to determine the dynamic type of the
+value.  If this value is of class type, it will return the class in
+which the value is embedded, if any.  If this value is of pointer or
+reference to a class type, it will compute the dynamic type of the
+referenced object, and return a pointer or reference to that type,
+respectively.  In all other cases, it will return the value's static
+type.
+
+Note that this feature will only work when debugging a C@t{++} program
+that includes @acronym{RTTI} for the object in question.  Otherwise,
+it will just return the static type of the value as in @kbd{ptype foo}
+(@pxref{Symbols, ptype}).
 @end defivar
 @end table