From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: Getting more info on a variable in Customize buffers Date: Sun, 2 Jan 2005 07:27:51 -0600 (CST) Message-ID: <200501021327.j02DRpq08157@raven.dms.auburn.edu> References: NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1104672616 10284 80.91.229.6 (2 Jan 2005 13:30:16 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 2 Jan 2005 13:30:16 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jan 02 14:30:09 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1Cl5o8-0005mU-00 for ; Sun, 02 Jan 2005 14:30:09 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Cl5zE-0001iS-8h for ged-emacs-devel@m.gmane.org; Sun, 02 Jan 2005 08:41:36 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1Cl5xu-0000en-GU for emacs-devel@gnu.org; Sun, 02 Jan 2005 08:40:14 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1Cl5xr-0000cY-90 for emacs-devel@gnu.org; Sun, 02 Jan 2005 08:40:12 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Cl5xq-0000c7-BQ for emacs-devel@gnu.org; Sun, 02 Jan 2005 08:40:10 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1Cl5m5-00086N-WB for emacs-devel@gnu.org; Sun, 02 Jan 2005 08:28:02 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id j02DRt0P011466; Sun, 2 Jan 2005 07:27:55 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id j02DRpq08157; Sun, 2 Jan 2005 07:27:51 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: drew.adams@oracle.com In-reply-to: X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:31685 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:31685 Drew Adams wrote (taking ediff-before-setup-windows-hook as example): So, I suggest: - To the Customize buffer for a group containing a variable, we add: 1) the real variable name, in such a way that it can be copied for pasting and searching and picked up by variable-at-point I personally agree that it would be better not to prettify variable names in Custom, but this probably has been discussed before. You can get the variable name by first clicking on "Show Value", then on "State" and then selecting "Show initial Lisp expression". 2) a link to the variable definition in the source code If you need to read the source code to customize a variable, then there is a really bad problem with the docstring. Somebody wanting to study source code is going to do C-h v. 3) a button to display the Lisp value of the variable (Hide/ Show/Show Lisp would do the trick). Can be done as explained under 1). In this case, the pretty form is sometimes more helpful to the user than the actual Lisp value. 4) perhaps a link to the variable's explanation in Info (when appropriate) The person writing the defcustom can already make such a link. (Using the :link keyword.) - To the Customize buffer for an individual variable only, we add: 1) everything listed above for the Customize group buffer 2) a link to the Customize group buffer There already is such a link. It says: Parent groups: Ediff Hook where "Ediff Hook" is a link you can follow. Sincerely, Luc.