Re: -symbol-list-lines doco update

Daniel Jacobowitz
2004-02-17T20:46:31Z

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