From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3838 invoked by alias); 16 Mar 2011 20:14:07 -0000 Received: (qmail 3813 invoked by uid 22791); 16 Mar 2011 20:13:58 -0000 X-SWARE-Spam-Status: No, hits=-6.1 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; Wed, 16 Mar 2011 20:13:52 +0000 Received: from int-mx01.intmail.prod.int.phx2.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id p2GKDo9f029925 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 16 Mar 2011 16:13:50 -0400 Received: from localhost.localdomain (ovpn01.gateway.prod.ext.phx2.redhat.com [10.5.9.1]) by int-mx01.intmail.prod.int.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id p2GKDmiL021650; Wed, 16 Mar 2011 16:13:49 -0400 From: Phil Muldoon To: Paul Koning Cc: Subject: Re: [python] [patch] Add is_valid to several classes References: <944D0115-C1D1-47F5-B1CD-FE3EC69A2ADC@dell.com> <2153F4C3-F1FE-488F-80C7-3368B2FCDD79@Dell.com> Reply-to: pmuldoon@redhat.com X-URL: http://www.redhat.com Date: Wed, 16 Mar 2011 22:01:00 -0000 In-Reply-To: <2153F4C3-F1FE-488F-80C7-3368B2FCDD79@Dell.com> (Paul Koning's message of "Wed, 16 Mar 2011 16:07:47 -0400") 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 X-IsSubscribed: yes 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: 2011-03/txt/msg00881.txt.bz2 Paul Koning writes: > On Mar 16, 2011, at 4:04 PM, Phil Muldoon wrote: > >> Paul Koning writes: >> >>> On Mar 16, 2011, at 12:02 PM, Phil Muldoon wrote: >>> >>>> ... >>>> +A @code{gdb.Block} object has the following methods: >>>> + >>>> +@table @code >>>> +@defmethod Block is_valid >>>> +Returns true if the @code{gdb.Block} object is valid, false if not. A >>>> +block object can become invalid if the block it refers to doesn't >>>> +exist anymore in the inferior. All @code{gdb.Block} methods will >>>> +throw an exception if it is invalid at the time the method is called. >>>> +This method is also made available to the Python iterator object that >>>> +@code{gdb.Block} supports via the Python method @code{iter} function. >>> >>> The iter built-in function, or any iteration context, right? For example, if b is a gdb.Block, you could say "for x in b:", presumably, and then "x.is_valid()" works. >> >> Yep, all iteration contexts that are valid with Python. > > So how about this wording: > This method is also made available to the Python iterator object that @code{gdb.Block} provides in iteration context and via the Python @code{iter} built-in function. > > paul That's fine with me. If Eli approves it, I will place it in the manual text. Cheers Phil