From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: standard error not in Elisp manual index Date: Sat, 31 Mar 2007 08:06:35 -0700 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1175353649 5734 80.91.229.12 (31 Mar 2007 15:07:29 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 31 Mar 2007 15:07:29 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Eli Zaretskii" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 31 17:07:27 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 1HXfAs-0004xk-Mp for ged-emacs-devel@m.gmane.org; Sat, 31 Mar 2007 17:07:26 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HXfDh-0000Kt-1p for ged-emacs-devel@m.gmane.org; Sat, 31 Mar 2007 10:10:21 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HXfDd-0000KR-DE for emacs-devel@gnu.org; Sat, 31 Mar 2007 11:10:17 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HXfDa-0000K6-P5 for emacs-devel@gnu.org; Sat, 31 Mar 2007 11:10:16 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HXfDa-0000K2-J2 for emacs-devel@gnu.org; Sat, 31 Mar 2007 10:10:14 -0500 Original-Received: from rgminet01.oracle.com ([148.87.113.118]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1HXfAk-00052r-F8; Sat, 31 Mar 2007 11:07:18 -0400 Original-Received: from rgmgw2.us.oracle.com (rgmgw2.us.oracle.com [138.1.186.111]) by rgminet01.oracle.com (Switch-3.2.4/Switch-3.1.6) with ESMTP id l2VF7Bt0027099; Sat, 31 Mar 2007 09:07:12 -0600 Original-Received: from acsmt351.oracle.com (acsmt351.oracle.com [141.146.40.151]) by rgmgw2.us.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id l2VEkV9v003167; Sat, 31 Mar 2007 09:07:11 -0600 Original-Received: from dhcp-amer-csvpn-gw2-141-144-72-91.vpn.oracle.com by acsmt351.oracle.com with ESMTP id 2577973551175353601; Sat, 31 Mar 2007 08:06:41 -0700 X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) In-Reply-To: Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3028 X-Whitelist: TRUE X-Whitelist: TRUE X-Brightmail-Tracker: AAAAAQAAAAI= X-detected-kernel: Linux 2.4-2.6 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:68839 Archived-At: > > 1. These terms are not in the index (at least in these forms): > > I added some of these (about half of what you suggested). That's much more than I expected. Thanks. > 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. Sounds good to me. > > 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. > > 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. I agree. > 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. I meant that `i memory' will not find node "Memory Usage", and so on. Thanks.