From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: automatic anchors for definition commands. Date: 08 Jan 2004 16:14:26 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200401072134.i07LY9A18724@f7.net> <200401080001.i0801xt11013@raven.dms.auburn.edu> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1073602411 19141 80.91.224.253 (8 Jan 2004 22:53:31 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 8 Jan 2004 22:53:31 +0000 (UTC) Cc: juri@jurta.org, emacs-devel@gnu.org, karl@freefriends.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Thu Jan 08 23:53:26 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1Aej1q-00073c-00 for ; Thu, 08 Jan 2004 23:53:26 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1Aej1q-0002tn-00 for ; Thu, 08 Jan 2004 23:53:26 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1Aehf5-0002Ty-Ez for emacs-devel@quimby.gnus.org; Thu, 08 Jan 2004 16:25:51 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AehVS-00017b-VS for emacs-devel@gnu.org; Thu, 08 Jan 2004 16:15:54 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1Aechl-0006Sx-MU for emacs-devel@gnu.org; Thu, 08 Jan 2004 11:08:49 -0500 Original-Received: from [207.232.27.5] (helo=WST0054) by monty-python.gnu.org with asmtp (Exim 4.24) id 1AebrQ-0007hI-9T; Thu, 08 Jan 2004 10:14:13 -0500 Original-To: Luc Teirlinck In-reply-to: <200401080001.i0801xt11013@raven.dms.auburn.edu> (message from Luc Teirlinck on Wed, 7 Jan 2004 18:01:59 -0600 (CST)) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:19109 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:19109 > Date: Wed, 7 Jan 2004 18:01:59 -0600 (CST) > From: Luc Teirlinck > > And as Eli says, sometimes reading from the beginning of the node > is better. > > In those cases I _do_ refer to the top of the node. I do not > _automatically_ make anchor references because a function or variable > name is mentioned. The point is, the author of the manual does not always know what's best; it depends on the reader. > The entire section `(elisp)Related Topics' consists of references to > definitions that are given in other chapters, but could quite as well > have been given in the functions chapter. I think such cases are relatively rare, even in the Emacs manuals, where we use that to keep the sheer size of the manuals at bay. It's not clear to me whether we should draw too general conclusions from these cases. Again, this my opinion is not very strong.