This is the mail archive of the
mailing list for the binutils project.
Re: [RFA] Add stabs entries for coalesced symbols.
- From: Klee Dienes <klee at apple dot com>
- To: Eli Zaretskii <eliz at is dot elta dot co dot il>
- Cc: binutils at sources dot redhat dot com,gdb-patches at sources dot redhat dot com
- Date: Mon, 9 Dec 2002 01:39:38 -0500
- Subject: Re: [RFA] Add stabs entries for coalesced symbols.
Yes; thanks for the explanation.
Just to be clear on why I was asking, my concern wasn't that it was the
only instance of "coalesced symbols" in the document, it was that it
was the only instance of @cindex in the document, and I was worried
that an index with only one entry could look awkward. But I suspect
after reading your response that your response would be "well, that
just means we probably need more @cindex entries to be added".
On Monday, December 9, 2002, at 01:06 AM, Eli Zaretskii wrote:
I'm afraid I don't understand the nature of your hesitance.
I ask only because it's the only one in the
An index entry is a powerful means for finding information in the
quickly and efficiently. It is quick because just typing "i coalesc
and then hitting [Enter] will take you to the section you wrote in both
Emacs and the stand-alone Info reader. It is efficient because index
entries are created by humans who are supposed to consider issues that
users are likely to think about when looking for specific information,
and therefore the phrases included in the index are already oriented
towards someone who searches for info.
In other words, indexing helps you use the manual as a reference.
whether the term "coalesced symbol" appears once or more than once in a
manual is not important for having an index entry for it. On the
contrary, since there is a definitive place where the manual explains
what a coalesced symbol is and how GDB handles it, having an index
for that one place is very important.
Does that resolve your concerns?