From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10743 invoked by alias); 9 Dec 2002 06:39:42 -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 10728 invoked from network); 9 Dec 2002 06:39:40 -0000 Received: from unknown (HELO mx05.cluster1.charter.net) (209.225.8.15) by sources.redhat.com with SMTP; 9 Dec 2002 06:39:40 -0000 Received: from [66.189.46.2] (HELO platinum.local.) by mx05.cluster1.charter.net (CommuniGate Pro SMTP 3.5.9) with ESMTP id 38524984; Mon, 09 Dec 2002 01:39:39 -0500 Date: Mon, 09 Dec 2002 10:22:00 -0000 Subject: Re: [RFA] Add stabs entries for coalesced symbols. Content-Type: text/plain; charset=US-ASCII; format=flowed Mime-Version: 1.0 (Apple Message framework v543) Cc: binutils@sources.redhat.com, gdb-patches@sources.redhat.com To: Eli Zaretskii From: Klee Dienes In-Reply-To: Message-Id: Content-Transfer-Encoding: 7bit X-SW-Source: 2002-12/txt/msg00280.txt.bz2 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 ask only because it's the only one in the >> document. > > I'm afraid I don't understand the nature of your hesitance. > > An index entry is a powerful means for finding information in the > manual > quickly and efficiently. It is quick because just typing "i coalesc > TAB" > 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. > Thus, > 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 > entry > for that one place is very important. > > Does that resolve your concerns?