From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: Info enhancements Date: Sun, 07 Dec 2003 19:59:11 +0200 Organization: JURTA Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <877k18bjbl.fsf@mail.jurta.org> References: <200312051827.hB5IRfk17741@f7.net> <200312052044.hB5KiCg06171@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1070820166 4885 80.91.224.253 (7 Dec 2003 18:02:46 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 7 Dec 2003 18:02:46 +0000 (UTC) Cc: bob@rattlesnake.com, emacs-devel@gnu.org, karl@freefriends.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun Dec 07 19:02:42 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1AT3Ew-0005Tf-00 for ; Sun, 07 Dec 2003 19:02:42 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AT3Ew-0006uh-00 for ; Sun, 07 Dec 2003 19:02:42 +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 1AT4AY-0000eB-Rq for emacs-devel@quimby.gnus.org; Sun, 07 Dec 2003 14:02:14 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AT4AT-0000e1-5v for emacs-devel@gnu.org; Sun, 07 Dec 2003 14:02:09 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AT49x-0000SE-9Y for emacs-devel@gnu.org; Sun, 07 Dec 2003 14:02:08 -0500 Original-Received: from [64.246.52.22] (helo=ns5.tangramltd.com) by monty-python.gnu.org with esmtp (TLSv1:DES-CBC3-SHA:168) (Exim 4.24) id 1AT49w-0000S7-UA for emacs-devel@gnu.org; Sun, 07 Dec 2003 14:01:37 -0500 Original-Received: from 80-235-42-190-dsl.mus.estpak.ee ([80.235.42.190] helo=mail.jurta.org) by ns5.tangramltd.com with esmtp (Exim 4.20) id 1AT3CP-0008I9-5C; Sun, 07 Dec 2003 20:00:05 +0200 Original-To: Luc Teirlinck In-Reply-To: <200312052044.hB5KiCg06171@raven.dms.auburn.edu> (Luc Teirlinck's message of "Fri, 5 Dec 2003 14:44:12 -0600 (CST)") User-Agent: Gnus/5.1003 (Gnus v5.10.3) Emacs/21.3.50 (gnu/linux) X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - ns5.tangramltd.com X-AntiAbuse: Original Domain - gnu.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - jurta.org 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:18513 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:18513 Luc Teirlinck writes: > Karl Berry wrote: > As for the xref stuff, I am not at all sure the second arg to xref > should be treated in a special way; that was not its original intent and > nothing has ever been documented about it. I didn't know standalone > info did any searching based on it. I'll have to think about that. > > The standalone info goes to the wrong place in the example we have > been looking at. Instead of going to the intended place: > > - Variable: file-coding-system-alist > > It goes to: > > files and the contents of `file-coding-system-alist' (see below). > > in the description of `auto-coding-regexp-alist'. > > While it is very useful to go to the intended place, it is a lot > better to just go to the top of the node than to attempt to guess. > Going to the wrong place misleads the user. Going to the wrong place will not mislead the user more than going to the top of the node because when user starts to scan visually the node by reading it from the top he soon encounters the first and wrong occurrence of the searched string. Now the user is exactly in the same situation as if point was placed here automatically by the Info reader. So it is the task of authors of Info manuals to warn the user that the right place is somewhere below. And as you can notice this is already done in the mentioned node. You can see that authors already added the warning "(see below)" exactly for this purpose! -- http://www.jurta.org/emacs/