From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 19447 invoked by alias); 21 Sep 2010 21:56:32 -0000 Received: (qmail 19439 invoked by uid 22791); 21 Sep 2010 21:56:31 -0000 X-SWARE-Spam-Status: No, hits=-6.2 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_HI,SPF_HELO_PASS,T_RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Tue, 21 Sep 2010 21:56:27 +0000 Received: from int-mx08.intmail.prod.int.phx2.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by mx1.redhat.com (8.13.8/8.13.8) with ESMTP id o8LLuIuP013535 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 21 Sep 2010 17:56:18 -0400 Received: from ns3.rdu.redhat.com (ns3.rdu.redhat.com [10.11.255.199]) by int-mx08.intmail.prod.int.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id o8LLuI1t011096; Tue, 21 Sep 2010 17:56:18 -0400 Received: from opsy.redhat.com (ovpn01.gateway.prod.ext.phx2.redhat.com [10.5.9.1]) by ns3.rdu.redhat.com (8.13.8/8.13.8) with ESMTP id o8LLuHVR024170; Tue, 21 Sep 2010 17:56:17 -0400 Received: by opsy.redhat.com (Postfix, from userid 500) id 24E24378875; Tue, 21 Sep 2010 15:56:17 -0600 (MDT) From: Tom Tromey To: Eli Zaretskii Cc: joel.borggren.franck@gmail.com, andre.poenitz@nokia.com, gdb-patches@sourceware.org Subject: Re: RFA: document Value.__init__ References: <201009161148.37670.andre.poenitz@nokia.com> <83wrqex22c.fsf@gnu.org> Date: Tue, 21 Sep 2010 22:50:00 -0000 In-Reply-To: <83wrqex22c.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 21 Sep 2010 22:40:43 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii 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 X-SW-Source: 2010-09/txt/msg00361.txt.bz2 Eli> OK, but the long list of conversions in the first paragraph could use Eli> a @table, I think. How about this? Tom 2010-09-21 Tom Tromey * gdb.texinfo (Values From Inferior): Mention Value.__init__. Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.764 diff -u -r1.764 gdb.texinfo --- gdb.texinfo 15 Sep 2010 19:31:59 -0000 1.764 +++ gdb.texinfo 21 Sep 2010 21:54:48 -0000 @@ -20774,6 +20774,41 @@ The following methods are provided: @table @code +@defmethod Value __init__ @var{val} +Many Python values can be converted directly to a @code{gdb.Value} via +this object initializer. Specifically: + +@table @asis +@item Python boolean +A Python boolean is converted to the boolean type from the current +language. + +@item Python integer +A Python integer is converted to the C @code{long} type for the +current architecture. + +@item Python long +A Python long is converted to the C @code{long long} type for the +current architecture. + +@item Python float +A Python float is converted to the C @code{double} type for the +current architecture. + +@item Python string +A Python string is converted to a target string, using the current +target encoding. + +@item @code{gdb.Value} +If @code{val} is a @code{gdb.Value}, then a copy of the value is made. + +@item @code{gdb.LazyString} +If @code{val} is a @code{gdb.LazyString} (@pxref{Lazy Strings In +Python}), then the lazy string's @code{value} method is called, and +its result is used. +@end table +@end defmethod + @defmethod Value cast type Return a new instance of @code{gdb.Value} that is the result of casting this instance to the type described by @var{type}, which must