From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: customizing a variable named in Info Date: 19 Oct 2003 07:58:30 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <4763.1066527268@mixed> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1066543181 16815 80.91.224.253 (19 Oct 2003 05:59:41 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 19 Oct 2003 05:59:41 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun Oct 19 07:59: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 1AB6bK-0000rS-00 for ; Sun, 19 Oct 2003 07:59:38 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AB6bK-0005E4-00 for ; Sun, 19 Oct 2003 07:59:38 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AB6ZH-0008NQ-SH for emacs-devel@quimby.gnus.org; Sun, 19 Oct 2003 01:57:31 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AB6Yr-0008J9-96 for emacs-devel@gnu.org; Sun, 19 Oct 2003 01:57:05 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AB6YL-0008BU-8m for emacs-devel@gnu.org; Sun, 19 Oct 2003 01:57:04 -0400 Original-Received: from [207.232.27.5] (helo=WST0054) by monty-python.gnu.org with asmtp (Exim 4.24) id 1AB6YK-0008BG-Ho; Sun, 19 Oct 2003 01:56:32 -0400 Original-To: Peter S Galbraith In-reply-to: <4763.1066527268@mixed> (message from Peter S Galbraith on Sat, 18 Oct 2003 21:34:28 -0400) 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:17242 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17242 > Date: Sat, 18 Oct 2003 21:34:28 -0400 > From: Peter S Galbraith > > It would be nice to have a way to identity an Emacs variable in texinfo > sources such that when Emacs Info renders the page it can make the > variable name clickable in order to customize it. I think this is a good idea, but it needs to be elaborated a bit in order to discuss its merits. For example, do you want _every_ instance of a variable's name in the manual to be clickable like that? That could be a bit annoying. If only some instances should be clickable, how do we tell Info which ones? Also, how would Info know which symbol is a variable? Variable names have the @code markup, which they share with all other symbols: functions, commands, X resources, environment variable names, etc. I think we might need a new Texinfo directive for this. Or we could have makeinfo generate something special for a variable mentioned in a paragraph that has a @vindex entry before it. > I know I can put point on the string, do `C-h v' and then click on > customize, but such a feature would make customizable variables stand > out and the documentation would therefore render the information in a > more efficient way (specially for new users). Perhaps some shorter procedure, like a key binding for "customize the variable at point", would do?