From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3790 invoked by alias); 9 Dec 2002 06:07:10 -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 3778 invoked from network); 9 Dec 2002 06:07:09 -0000 Received: from unknown (HELO is.elta.co.il) (199.203.121.2) by sources.redhat.com with SMTP; 9 Dec 2002 06:07:09 -0000 Received: from is (is [199.203.121.2]) by is.elta.co.il (8.9.3/8.8.8) with SMTP id IAA02591; Mon, 9 Dec 2002 08:06:54 +0200 (IST) Date: Sun, 08 Dec 2002 22:39:00 -0000 From: Eli Zaretskii X-Sender: eliz@is To: Klee Dienes cc: binutils@sources.redhat.com, gdb-patches@sources.redhat.com Subject: Re: [RFA] Add stabs entries for coalesced symbols. In-Reply-To: <4EBE70E3-0B0E-11D7-9779-00039396EEB8@apple.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-SW-Source: 2002-12/txt/msg00279.txt.bz2 On Sun, 8 Dec 2002, Klee Dienes wrote: > Thanks to everyone for the feedback. Thanks for working on this. The doco patch is approved. > One question for Eli: are you sure you want a @cindex entry for > "coalesced symbols"? Yes, I'm quite sure adding such an index entry is a Good Thing. > 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?