From: Andrew STUBBS <andrew.stubbs@st.com>
To: Ian Lance Taylor <ian@airs.com>
Cc: binutils@sources.redhat.com
Subject: Re: Output format documentation
Date: Wed, 14 Sep 2005 15:50:00 -0000 [thread overview]
Message-ID: <43280277.6010600@st.com> (raw)
In-Reply-To: <m3acigyekt.fsf@gossamer.airs.com>
Ian Lance Taylor wrote:
> Andrew STUBBS <andrew.stubbs@st.com> writes:
>>SYMBOL TABLE:
>>a0000000 l d .text 00000000
>
> 'l' means a local symbol.
>
> 'd' means a debugging symbol.
>
> 'f' means a file symbol.
>
>>Is there some documentation I have missed?
>
> Probably not.
Then how do you know? Ok, silly question, but you get my point. I notice
that you make no attempt the explain the '00000000'.
>>Whether or not there are any now, please can I request that somebody
>>in the know inserts some useful descriptions into the official docs
>>for the next version of binutils. Some column header in the tool
>>output might not be a bad plan either. I know there is a problem in
>>that the different data formats have different output, but at least
>>the most common one ought to have something written.
>
>
> The documentation does indeed have many weaknesses. Patches are
> welcome.
I don't really have time for our own documentation, never mind anybody
else's, and yes, I'm sure the same is true for many people which is why
the docs are so short in the first place.
That said, I might be able to find a little time now and again to have a
bash, but it still wouldn't do any good because I wouldn't be able to
come up with anything better than that you put above. I mean, 'd' might
be a debugging symbol, and I already guessed that from the source, but
what does it mean for a symbol to have this flag? What does it mean to
have a nameless symbol like the one above? Why are filenames listed as
symbols? How come that column can be either 'd' for debug or 'D' for
dynamic? That's the sort of information that should be in the docs, and
that's the stuff only insiders can really know.
Sigh, if somebody were to explain it to me I might find time to have a
go at a patch, slowly, in between other work.
Andrew
next prev parent reply other threads:[~2005-09-14 11:00 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2005-09-13 19:04 Andrew STUBBS
2005-09-14 1:34 ` Ian Lance Taylor
2005-09-14 15:50 ` Andrew STUBBS [this message]
2005-09-14 18:50 ` Ian Lance Taylor
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=43280277.6010600@st.com \
--to=andrew.stubbs@st.com \
--cc=binutils@sources.redhat.com \
--cc=ian@airs.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).