From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.comp.tex.texinfo.pretest,gmane.emacs.devel Subject: Re: Info enhancements Date: Wed, 03 Dec 2003 07:38:02 +0200 Organization: JURTA Sender: texinfo-pretest-bounces@texinfo.org Message-ID: <87vfoysbnt.fsf@mail.jurta.org> References: <9743-Tue02Dec2003192702+0200-eliz@elta.co.il> <200312021926.hB2JQxB27349@f7.net> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1070430180 11827 80.91.224.253 (3 Dec 2003 05:43:00 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 3 Dec 2003 05:43:00 +0000 (UTC) Cc: texinfo-pretest@texinfo.org Original-X-From: texinfo-pretest-bounces@texinfo.org Wed Dec 03 06:42:56 2003 Return-path: Original-Received: from consort.superb.net ([209.61.216.22] helo=f7.net) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1ARPmq-0006wt-00 for ; Wed, 03 Dec 2003 06:42:56 +0100 Original-Received: from consort.superb.net (localhost [127.0.0.1]) by f7.net (8.11.7-20030920/8.11.7) with ESMTP id hB35gkM19404; Wed, 3 Dec 2003 00:42:47 -0500 Original-Received: from ns5.tangramltd.com (ns5.tangramltd.com [64.246.52.22]) by f7.net (8.11.7-20030920/8.11.7) with ESMTP id hB35giM19373 for ; Wed, 3 Dec 2003 00:42:44 -0500 Original-Received: from 80-235-33-11-dsl.mus.estpak.ee ([80.235.33.11] helo=mail.jurta.org) by ns5.tangramltd.com with esmtp (Exim 4.20) id 1ARPmb-0008E8-9F; Wed, 03 Dec 2003 07:42:41 +0200 Original-To: karl@freefriends.org (Karl Berry) In-Reply-To: <200312021926.hB2JQxB27349@f7.net> (Karl Berry's message of "Tue, 2 Dec 2003 14:26:59 -0500") 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 - texinfo.org X-AntiAbuse: Originator/Caller UID/GID - [0 0] / [47 12] X-AntiAbuse: Sender Address Domain - jurta.org Original-cc: emacs-devel@gnu.org X-BeenThere: texinfo-pretest@texinfo.org X-Mailman-Version: 2.1 Precedence: list List-Id: Texinfo development and discussion. List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: texinfo-pretest-bounces@texinfo.org Xref: main.gmane.org gmane.comp.tex.texinfo.pretest:1177 gmane.emacs.devel:18307 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:18307 karl@freefriends.org (Karl Berry) writes: > > From: Juri Linkov > > Date: Tue, 02 Dec 2003 12:18:09 +0200 > > > > Yes, using anchors might be a more clean solution, but it has one > > drawback: it will generate too many excessive references in the tag > > table for its Info file. And these references will be mixed up with > > node names, e.g. in the completion list of `Info-goto-node'. > > Perhaps there should be a way to tell Info-goto-node to complete on > node names only, or maybe we should have two distinct commands, one > which considers only nodes, the other which considers all entries in > the tag tables. > > Once again I've been removed from the thread. What is under discussion now? There is a problem of more accurate addressing of a position within a given Info node. For example, currently the Glossary node of the Emacs Manual has non-functional references that merely has a form of a simple text "(q.v.)" or "See `default.'". There are many other places in Info documentation where more exact referencing is needed. This discussion currently goes about two solutions to this problem: - use anchors for example: @item Argument @xref{Numeric Argument}. ... @item Numeric Argument @anchor{Numeric Argument} A numeric argument is a number, specified before a command, to change - or use reference names @item Argument @xref{Glossary,Numeric Argument}. This works by selecting an Info node ("Glossary") and then by using some heuristics to find a needed position in this Info node. The stand-alone Info reader searches for the first occurrence of the reference name ("Numeric Argument") and moves point here. The Emacs Info reader now uses the function `Info-find-index-name' to move point to the place within the current node where reference name ("Numeric Argument") is defined (but still sometimes it misses the correct place). If the solution will be to use anchors, then I can suggest to develop it further and generate anchors (i.e. Ref: tags in tag tables of Info files) from all indexing commands (@findex, @vindex, etc.). Currently their positions are not available in Info files, but it might be useful to jump unambiguously to positions in Info files where these index entries were defined in Texinfo source files. -- http://www.jurta.org/emacs/ _______________________________________________ Texinfo home page: http://www.gnu.org/software/texinfo/ texinfo-pretest@texinfo.org http://ff0.org/mailman/listinfo/texinfo-pretest