From fccd1d1e5f52fe58263f77522339067e2a6064c8 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Wed, 22 Sep 2010 09:13:31 +0000 Subject: [PATCH] gdb.texinfo (Values From Inferior): Clarify that value.dynamic_type works only in C++ programs with RTTI. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 18 ++++++++++++------ 2 files changed, 17 insertions(+), 6 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 579b7c56b5d..b3ca8af741f 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2010-09-22 Eli Zaretskii + + * gdb.texinfo (Values From Inferior): Clarify that + value.dynamic_type works only in C++ programs with RTTI. + 2010-09-15 Paul Bolle * gdb.texinfo (Character Sets): Correctly reference host-charset diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index b59ce0d2f28..e5be50945aa 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -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 -- 2.30.2