From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 49241 invoked by alias); 8 Sep 2018 20:14:56 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 48786 invoked by uid 89); 8 Sep 2018 20:14:52 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-25.5 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_0,GIT_PATCH_1,GIT_PATCH_2,GIT_PATCH_3,RCVD_IN_DNSWL_NONE,SPF_HELO_PASS autolearn=ham version=3.3.2 spammy=ct X-HELO: gateway34.websitewelcome.com Received: from gateway34.websitewelcome.com (HELO gateway34.websitewelcome.com) (192.185.149.222) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sat, 08 Sep 2018 20:14:50 +0000 Received: from cm15.websitewelcome.com (cm15.websitewelcome.com [100.42.49.9]) by gateway34.websitewelcome.com (Postfix) with ESMTP id 11FE4DA432 for ; Sat, 8 Sep 2018 15:14:49 -0500 (CDT) Received: from box5379.bluehost.com ([162.241.216.53]) by cmsmtp with SMTP id yjcgf2f8DbXuJyjctfMGkj; Sat, 08 Sep 2018 15:14:48 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=tromey.com; s=default; h=References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From: Sender:Reply-To:MIME-Version:Content-Type:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=EMEwYs3zgy/6MpY5gCKgkkaHN5183F/CTapbh9ipqoc=; b=jlu98l9N7qfyoW2BzlGSntELea YFeHL6MzzuzWy5JzLiUlDWsxNukVROycVypWrkBHYVf3kAf+TZBQ7YmewyMg1745E/+CbWjjQFjHa rEpfH4lqm/lVQRSFM/Rpsn9Tf; Received: from 75-166-85-72.hlrn.qwest.net ([75.166.85.72]:47090 helo=bapiya.Home) by box5379.bluehost.com with esmtpsa (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.91) (envelope-from ) id 1fyjcf-002ImX-VN; Sat, 08 Sep 2018 15:14:26 -0500 From: Tom Tromey To: gdb-patches@sourceware.org Cc: Tom Tromey Subject: [PATCH 12/14] Mention virtual tables in Python dynamic_type documentation Date: Sat, 08 Sep 2018 20:14:00 -0000 Message-Id: <20180908201417.13444-13-tom@tromey.com> In-Reply-To: <20180908201417.13444-1-tom@tromey.com> References: <20180908201417.13444-1-tom@tromey.com> X-SW-Source: 2018-09/txt/msg00177.txt.bz2 PR python/16461 asks that the Python dynamic_type documentation mention virtual tables; this patch implements that request. gdb/doc/ChangeLog 2018-09-08 Tom Tromey PR python/16461: * python.texi (Values From Inferior): Mention use of virtual table. --- gdb/doc/ChangeLog | 6 ++++++ gdb/doc/python.texi | 16 ++++++++-------- 2 files changed, 14 insertions(+), 8 deletions(-) diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi index 6eccc2b1154..e310c16c0a9 100644 --- a/gdb/doc/python.texi +++ b/gdb/doc/python.texi @@ -658,14 +658,14 @@ The type of this @code{gdb.Value}. The value of this attribute is a @end defvar @defvar Value.dynamic_type -The dynamic type of this @code{gdb.Value}. This uses C@t{++} run-time -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. +The dynamic type of this @code{gdb.Value}. This uses the object's +virtual table and the C@t{++} run-time 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, -- 2.13.6