From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-81999-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 11230 invoked by alias); 4 Jul 2011 12:05:52 -0000
Received: (qmail 11217 invoked by uid 22791); 4 Jul 2011 12:05:47 -0000
X-SWARE-Spam-Status: No, hits=-1.9 required=5.0	tests=AWL,BAYES_00,T_RP_MATCHES_RCVD
X-Spam-Check-By: sourceware.org
Received: from fencepost.gnu.org (HELO fencepost.gnu.org) (140.186.70.10)    by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Mon, 04 Jul 2011 12:05:34 +0000
Received: from eliz by fencepost.gnu.org with local (Exim 4.71)	(envelope-from <eliz@gnu.org>)	id 1Qdhu9-0001Bt-9i; Mon, 04 Jul 2011 08:05:33 -0400
Date: Mon, 04 Jul 2011 13:14:00 -0000
Message-Id: <E1Qdhu9-0001Bt-9i@fencepost.gnu.org>
From: Eli Zaretskii <eliz@gnu.org>
To: Matt Rice <ratmice@gmail.com>
CC: pmuldoon@redhat.com, gdb-patches@sourceware.org
In-reply-to:	<CACTLOFqppKbUTP7NMauBXJKy+3ptuKzETzU5Ds6Zad1uBvHoVg@mail.gmail.com>	(message from Matt Rice on Mon, 4 Jul 2011 03:50:11 -0700)
Subject: Re: [patch] [python] find_line_pc_range
Reply-to: Eli Zaretskii <eliz@gnu.org>
References: <CACTLOFptUbx6vtmykDBxtqv3GcrGTQXzX4m6q6O4X4ddw2WM1w@mail.gmail.com>	<m3y60fmj76.fsf@redhat.com>	<CACTLOFo5rD6PCLeK+hmoBt-vAHGJZDNS_gPbZG6tP=CP=gFeog@mail.gmail.com>	<E1QdgWn-0000jL-3M@fencepost.gnu.org> <CACTLOFqppKbUTP7NMauBXJKy+3ptuKzETzU5Ds6Zad1uBvHoVg@mail.gmail.com>
MIME-version: 1.0
Content-type: text/plain; charset=windows-1252
Content-Transfer-Encoding: 8bit
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2011-07/txt/msg00094.txt.bz2

> Date: Mon, 4 Jul 2011 03:50:11 -0700
> From: Matt Rice <ratmice@gmail.com>
> Cc: pmuldoon@redhat.com, gdb-patches@sourceware.org
> 
> >> +@defmethod Symtab_and_line find_line_pc_range
> >> +If found returns a @code{Tuple} containing the start and end program counter
> >> +addresses for the line attribute.  Otherwise returns @code{None}.
> >
> > Sorry, I don't understand what you are trying to say here.
> >  "If found"
> > what?
> 
> Sorry, I abhor writing.
> find_line_pc_range will not find a range in cases where
> the code is not associated with a line (no debug symbols), or the line
> is not associated with code (ifdef'd out or something).
> 
> >  And what "line attribute" do you refer to?
> 
> this thing:
> — Instance Variable of Symtab_and_line: line
> 
> Indicates the current line number for this object. This attribute is
> not writable.

Thanks for explaining.  I would rephrase as follows:

  Attempt to find the range of program counter addresses for the
  @code{line} attribute of the @code{Symtab_and_line} object.  If
  found, return a @code{Tuple} containing the start and end addresses
  for the line.  Otherwise (e.g., a line with no corresponding code or
  not present in the debug info), return @code{None}.