Re: -symbol-list-lines doco update

[Daniel Jacobowitz <drow at false dot org>]

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