From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: Re: doc of eval-defun (C-M-x) Date: Tue, 10 Jul 2007 23:08:37 +0300 Message-ID: References: Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: sea.gmane.org 1184098127 27728 80.91.229.12 (10 Jul 2007 20:08:47 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 10 Jul 2007 20:08:47 +0000 (UTC) Cc: bug-gnu-emacs@gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jul 10 22:08:45 2007 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1I8M0o-0001Kq-GI for geb-bug-gnu-emacs@m.gmane.org; Tue, 10 Jul 2007 22:08:42 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1I8M0o-00029H-4y for geb-bug-gnu-emacs@m.gmane.org; Tue, 10 Jul 2007 16:08:42 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1I8M0m-000299-0Q for bug-gnu-emacs@gnu.org; Tue, 10 Jul 2007 16:08:40 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1I8M0k-000284-K4 for bug-gnu-emacs@gnu.org; Tue, 10 Jul 2007 16:08:39 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1I8M0k-00027p-F1 for bug-gnu-emacs@gnu.org; Tue, 10 Jul 2007 16:08:38 -0400 Original-Received: from heller.inter.net.il ([213.8.233.23]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1I8M0j-00087E-OS for bug-gnu-emacs@gnu.org; Tue, 10 Jul 2007 16:08:38 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-83-130-199-29.inter.net.il [83.130.199.29]) by heller.inter.net.il (MOS 3.7.3a-GA) with ESMTP id DBC94315 (AUTH halo1); Tue, 10 Jul 2007 23:08:35 +0300 (IDT) In-reply-to: X-detected-kernel: FreeBSD 4.7-5.2 (or MacOS X 10.2-10.4) (2) X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:16130 Archived-At: > From: "Drew Adams" > Cc: > Date: Tue, 10 Jul 2007 09:19:28 -0700 > > As to explaining why it should be indexed, that explanation is now > irrelevant, unfortunately, since RMS has said: > > > We don't use the index that way. > > Nevertheless, FWIW, my thinking was that, since `eval-defun' is discussed in > that node, and this use of `eval-defun' is as common as the `edebug' use > (IMO), it would be good to help readers find the discussion of `eval-defun' > in the context of `defvar' and `defcustom' (and `defface' as well). We index > the edebug discussion of `eval-defun'; we should also index the use with > `C-M-x', which is just as common. I'm not sure I understand what Richard meant by ``use the index that way'', but let me give you my personal perspective, FWIW: we do not index each and every instance where a certain symbol is mentioned. We always index the instance where it is explained in the most detailed way, and then additionally index select other places (appropriately qualified, as in "foo (and bar)") where it is mentioned in the context of some other feature, if those places reveal something important that isn't covered in the locus of the main documentation. So the question is: what do those two nodes say about `eval-defun' that its main documentation in the Emacs user manual does not?