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: Sat, 06 Dec 2003 02:15:43 +0200 Organization: JURTA Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <87brqmiy1o.fsf@mail.jurta.org> References: <878ylrbbk4.fsf@mail.jurta.org> <200312051426.hB5EQeZ11287@f7.net> <87ekvjuuj8.fsf@mail.jurta.org> <2719-Fri05Dec2003194408+0200-eliz@elta.co.il> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1070674662 32625 80.91.224.253 (6 Dec 2003 01:37:42 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 6 Dec 2003 01:37:42 +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 Sat Dec 06 02:37:38 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 1ASRO6-0004j4-00 for ; Sat, 06 Dec 2003 02:37:38 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1ASRO5-0006zu-01 for ; Sat, 06 Dec 2003 02:37:38 +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 1ASSJ5-0000wv-QC for emacs-devel@quimby.gnus.org; Fri, 05 Dec 2003 21:36:31 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1ASSHU-0000eJ-8P for emacs-devel@gnu.org; Fri, 05 Dec 2003 21:34:52 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1ASSGy-0000Zl-Bc for emacs-devel@gnu.org; Fri, 05 Dec 2003 21:34:51 -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 1ASSGy-0000Zi-0l for emacs-devel@gnu.org; Fri, 05 Dec 2003 21:34:20 -0500 Original-Received: from 80-235-35-6-dsl.mus.estpak.ee ([80.235.35.6] helo=mail.jurta.org) by ns5.tangramltd.com with esmtp (Exim 4.20) id 1ASRJU-0000XX-NY; Sat, 06 Dec 2003 03:32:53 +0200 Original-To: Eli Zaretskii In-Reply-To: <2719-Fri05Dec2003194408+0200-eliz@elta.co.il> (Eli Zaretskii's message of "Fri, 05 Dec 2003 19:44:08 +0200") 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 - [0 0] / [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:18452 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:18452 "Eli Zaretskii" writes: >> From: Juri Linkov >> Date: Fri, 05 Dec 2003 17:57:31 +0200 >> > >> > What is the Texinfo source that is generating this? Texinfo does not >> > have a way to make an xref to index entries, as far as I know. >> >> This is generated by the `@ref' with two arguments: >> >> @ref{Default Coding Systems, file-coding-system-alist} > > A digression: My personal view is that this is bad usage of Texinfo. > Instead of saying > > This function looks up the target in @ref{Default Coding Systems, > file-coding-system-alist} > > which looks awkward in Info and downright incomprehensible in the > printed copy, it is much better to say > > This function looks up the target in > @code{file-coding-system-alist} (@pxref{Default Coding Systems, > file-coding-system-alist}) But this looks awkward in Info with Info-hide-note-references equal t: This function looks up the target in file-coding-system-alist (see file-coding-system-alist). whereas the first variant is better: This function looks up the target in file-coding-system-alist. So the variant that will look equally good in Info with Info-hide-note-references equal to t or nil and in the printed copy has yet to be found. -- http://www.jurta.org/emacs/