From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#10451: 24.0.92; Bad cross reference in Info manual Date: Sun, 8 Jan 2012 10:56:54 -0800 Message-ID: References: <831uraf4h7.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1326049082 23203 80.91.229.12 (8 Jan 2012 18:58:02 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 8 Jan 2012 18:58:02 +0000 (UTC) Cc: 10451@debbugs.gnu.org To: "'Eli Zaretskii'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jan 08 19:57:58 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RjxwL-0001HK-Ul for geb-bug-gnu-emacs@m.gmane.org; Sun, 08 Jan 2012 19:57:58 +0100 Original-Received: from localhost ([::1]:45664 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RjxwL-00018H-LD for geb-bug-gnu-emacs@m.gmane.org; Sun, 08 Jan 2012 13:57:57 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:39496) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RjxwI-00017y-61 for bug-gnu-emacs@gnu.org; Sun, 08 Jan 2012 13:57:56 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RjxwH-0004qM-2l for bug-gnu-emacs@gnu.org; Sun, 08 Jan 2012 13:57:54 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:55621) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RjxwG-0004qI-WD for bug-gnu-emacs@gnu.org; Sun, 08 Jan 2012 13:57:53 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1RjxwQ-0005WW-7r for bug-gnu-emacs@gnu.org; Sun, 08 Jan 2012 13:58:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 08 Jan 2012 18:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10451 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 10451-submit@debbugs.gnu.org id=B10451.132604904321188 (code B ref 10451); Sun, 08 Jan 2012 18:58:02 +0000 Original-Received: (at 10451) by debbugs.gnu.org; 8 Jan 2012 18:57:23 +0000 Original-Received: from localhost ([127.0.0.1]:50294 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rjxvn-0005Vh-32 for submit@debbugs.gnu.org; Sun, 08 Jan 2012 13:57:23 -0500 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:41957) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rjxvk-0005VU-J9 for 10451@debbugs.gnu.org; Sun, 08 Jan 2012 13:57:21 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id q08Iv4AM008095 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 8 Jan 2012 18:57:05 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q08Iv3ht019344 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 8 Jan 2012 18:57:04 GMT Original-Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q08Iv3Ee012835; Sun, 8 Jan 2012 12:57:03 -0600 Original-Received: from dradamslap1 (/10.159.35.13) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 08 Jan 2012 10:57:02 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <831uraf4h7.fsf@gnu.org> Thread-Index: AczOMRut9io+5wy7TxmmBp+Zge2gIQABIAFA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090208.4F09E701.0039,ss=1,re=0.000,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:55546 Archived-At: > > I am suggesting what I said: let's try to cross-ref to a different > > manual, in particular one that is included with Emacs. The Emacs > > manual, for instance. > > AFAIK, Texinfo cross-references are not explained in the Emacs > manual. The real cross-reference to Texinfo, a few sentences below, > needs to go there. Pointing it to another manual would do a > disservice to the reader. That is completely wrong. That "real cross-reference to Texinfo, a few sentences below" does **not at all** need to be a reference to Texinfo. It is simply an example of a cross ref to another manual - nothing more. The purpose of that cross ref in this node, like the overall purpose of the node, is to introduce cross references and demo following them. The user is not expected here to follow a link to another manual to learn about that manual's subject matter, but simply to go there and come back, to see what following a cross ref link is like. This is that "real cross-reference to Texinfo", which you mention: "However, Emacs normally hides some other text in cross-references. If you put your mouse over the cross reference, then the information appearing in a separate box (tool tip) or in the echo area will show the full cross-reference including the file name and the node name of the cross reference. If you have a mouse, just leave it over the cross reference *Note Overview of Texinfo: (texinfo)Top, and watch what happens." There is nothing special about referring to the Texinfo manual here. Both this cross ref and the one in the paragraph before it (see below) could just as well be changed to a cross ref to another manual - a manual that is more likely to be present in Emacs. The Emacs manual is an obvious choice. Of course, the text needs to be modified to replace "the name `texinfo'" by "the name `emacs'", in addition to replacing the cross ref by a cross ref to the Emacs manual: "Sometimes a cross reference (or a node) can lead to another file (in other words another "manual"), or, on occasion, even a file on a remote machine (although Info files distributed with Emacs or the stand-alone Info avoid using remote links). Such a cross reference looks like this: *Note The Emacs Editor: (emacs)Top. (After following this link, type `l' to get back to this node.) Here the name `emacs' between parentheses refers to the file name. This file name appears in cross references and node names if it differs from the current file, so you can always know that you are going to be switching to another manual and which one." Is this really so hard for you to see?