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 23:21:45 +0200 Organization: JURTA Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <87brqkl3x2.fsf@mail.jurta.org> References: <878ylrbbk4.fsf@mail.jurta.org> <200312051426.hB5EQeZ11287@f7.net> <87ekvjuuj8.fsf@mail.jurta.org> <200312051802.hB5I2EC04476@raven.dms.auburn.edu> <87d6b2iyec.fsf@mail.jurta.org> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1070832389 25995 80.91.224.253 (7 Dec 2003 21:26:29 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 7 Dec 2003 21:26:29 +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 22:26:25 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 1AT6Q5-0005Pt-00 for ; Sun, 07 Dec 2003 22:26:25 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AT6Q5-0001m4-00 for ; Sun, 07 Dec 2003 22:26:25 +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 1AT7MI-0004iA-8t for emacs-devel@quimby.gnus.org; Sun, 07 Dec 2003 17:26:34 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AT7Lx-0004hw-Hf for emacs-devel@gnu.org; Sun, 07 Dec 2003 17:26:13 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AT7LR-0003Zf-1n for emacs-devel@gnu.org; Sun, 07 Dec 2003 17:26:12 -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 1AT7LQ-0003ZH-CI; Sun, 07 Dec 2003 17:25:40 -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 1AT6Nr-0005kj-0O; Sun, 07 Dec 2003 23:24:07 +0200 Original-To: rms@gnu.org In-Reply-To: (Richard Stallman's message of "Sun, 07 Dec 2003 12:19:12 -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 - 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:18522 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:18522 Richard Stallman writes: > What do you think about writing a variable name in a third argument > of @xref with the empty second argument? > > ============================================================ > This function looks up the target in > @ref{Default Coding Systems, , file-coding-system-alist}, > @ref{Default Coding Systems, , process-coding-system-alist}, or > @ref{Default Coding Systems, , network-coding-system-alist}, > depending on @var{operation}. > > Doesn't the variable name come out in the wrong font? > It ought to be in @code, but it won't be if. Yes, one disadvantage of this is that it comes out in the wrong font. So I tend to agree with Eli that it is better to write This function looks up the target in @code{file-coding-system-alist} (@pxref{Default Coding Systems, file-coding-system-alist}) which produces in the printed copy This function looks up the target in file-coding-system-alist (see Section 33.10.5 [Default Coding Systems], page 686). and in Info This function looks up the target in `file-coding-system-alist' (*note file-coding-system-alist: Default Coding Systems.) Although with Info-hide-note-references=t it looks awkward This function looks up the target in file-coding-system-alist (file-coding-system-alist.) but it's desired awkwardness for users that want to hide the note tag. -- http://www.jurta.org/emacs/