From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3254 invoked by alias); 17 Feb 2004 20:46:31 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 3235 invoked from network); 17 Feb 2004 20:46:29 -0000 Received: from unknown (HELO nevyn.them.org) (66.93.172.17) by sources.redhat.com with SMTP; 17 Feb 2004 20:46:29 -0000 Received: from drow by nevyn.them.org with local (Exim 4.30 #1 (Debian)) id 1AtC6u-0001Vo-Ms for ; Tue, 17 Feb 2004 15:46:28 -0500 Date: Tue, 17 Feb 2004 20:46:00 -0000 From: Daniel Jacobowitz To: gdb-patches@sources.redhat.com Subject: Re: -symbol-list-lines doco update Message-ID: <20040217204628.GB5744@nevyn.them.org> Mail-Followup-To: gdb-patches@sources.redhat.com References: <20040217154339.GA5684@white> <9003-Tue17Feb2004212321+0200-eliz@elta.co.il> <20040217200911.GD5982@white> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040217200911.GD5982@white> User-Agent: Mutt/1.5.1i X-SW-Source: 2004-02/txt/msg00485.txt.bz2 On Tue, Feb 17, 2004 at 03:09:11PM -0500, Bob Rossi wrote: > > Please use "@itemize @minus" and "@item" here, like this: > > > > There are two interesting points to be mentioned here. > > > > @itemize @minus > > @item > > The line number can be returned as ``0''. The line number ``0'' means > > > > etc., I hope you get the point. The Texinfo translators, like > > makeinfo and TeX, will then take care of producing the "-" before > > every @item, and will also indent the list so it looks pretty. > > Understood, thanks. Andrew, I will use @bullet. > > > > +For example, PCs greater than 0x8048406 that > > > +don't have a new starting line do not belong to this line number table. > > I don't even know what this means. That's why it's confusing. Maybe > Daniel can give us a better description, otherwise, I'll just put > > The line number can be returned as ''0''. > > I will resubmit this patch soon, if Daniel doesn't have a better > description. I'm not especially good with documentation. Let me see if I can explain the comment, and then maybe you can think of a better way to say it... An entry in the line table is "starting PC" and "line". But a line is not a starting PC, it's a range of PC values from start to end. The end is taken from the next line entry in the table. The line table: 0x0 1 0x4 2 0x8 4 0xc 0 means: line 1 from 0x0 to 0x3 line 2 from 0x4 to 0x7 line 4 from 0x8 to 0xb no line number information at 0xc -- Daniel Jacobowitz MontaVista Software Debian GNU/Linux Developer