From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: standard error not in Elisp manual index Date: Sat, 31 Mar 2007 17:57:48 +0300 Message-ID: References: Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: sea.gmane.org 1175353085 4085 80.91.229.12 (31 Mar 2007 14:58:05 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 31 Mar 2007 14:58:05 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 31 16:57:59 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1HXf1i-0003Ta-T5 for ged-emacs-devel@m.gmane.org; Sat, 31 Mar 2007 16:57:59 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HXf4X-0007mF-8G for ged-emacs-devel@m.gmane.org; Sat, 31 Mar 2007 10:00:53 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HXf4T-0007iK-T5 for emacs-devel@gnu.org; Sat, 31 Mar 2007 11:00:49 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HXf4S-0007fp-GR for emacs-devel@gnu.org; Sat, 31 Mar 2007 11:00:49 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HXf4S-0007fL-96 for emacs-devel@gnu.org; Sat, 31 Mar 2007 10:00:48 -0500 Original-Received: from nitzan.inter.net.il ([213.8.233.22]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1HXf1c-0003T6-SE for emacs-devel@gnu.org; Sat, 31 Mar 2007 10:57:53 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-84-229-214-84.inter.net.il [84.229.214.84]) by nitzan.inter.net.il (MOS 3.7.3a-GA) with ESMTP id GKO89218 (AUTH halo1); Sat, 31 Mar 2007 17:57:49 +0300 (IDT) In-reply-to: X-detected-kernel: FreeBSD 4.7-5.2 (or MacOS X 10.2-10.4) (2) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:68838 Archived-At: > From: "Drew Adams" > Cc: > Date: Sat, 24 Mar 2007 13:54:26 -0700 > > > > There might be other top-level menu terms that should also be in the > > > index. > > > > Yes, there might, so please tell if you find any. > > 1. These terms are not in the index (at least in these forms): I added some of these (about half of what you suggested). Some reasons for not adding the others: . Minor differences wrt to existing entries (e.g., "do something" when "doING something" already exists). . Entries that might be suitable for the user manual, not for the ELisp manual, whose readers are programmers looking for Lisp features. Examples: copy text, cut, FOO mode, utf-8. . Entries for issues that people are unlikely to look up in this specific manual. Example: gpl. > 2. As a rule of thumb, it would be good for each of the top-level menu items > to be the first or near the first hit for the keywords in that item name, or > keywords closely associated with that item name. > > For example, the node addressed by menu item _Functions_ should be among the > first hits if you use `i function'. As it is now, that node is accessed only > after a hundred or so uses of `,' after `i function'. Consider doing this > for these top-level menu items: While I agree with the feature you suggest, I don't think that its implementation should by by tweaking index entries in the manual. More likely, this is something Info should do when it sorts hits for display. So I didn't use the suggestions in this group. > 3. These terms have no entries for the nodes in parens: > > memory (Memory Usage) > documentation (Documentation Tips) > warning (Warning Tips) > key binding (Key Binding Conventinos) I'm not sure what you meant by these. Please explain. Thanks again for taking time to write these suggestions.