From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: option doc strings and Customize tags Date: Tue, 28 Oct 2008 23:45:15 -0700 Message-ID: <007e01c93991$e714c8f0$0200a8c0@us.oracle.com> References: <005601c9385f$86a998c0$c2b22382@us.oracle.com><4907637E.8090402@gmx.at><005201c93933$6bd2eb30$0200a8c0@us.oracle.com> <87hc6wf7u2.fsf@uwakimon.sk.tsukuba.ac.jp> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1225262733 2889 80.91.229.12 (29 Oct 2008 06:45:33 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 29 Oct 2008 06:45:33 +0000 (UTC) Cc: 'martin rudalics' , emacs-devel@gnu.org To: "'Stephen J. Turnbull'" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Oct 29 07:46:34 2008 connect(): Connection refused Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1Kv4p8-00056S-6C for ged-emacs-devel@m.gmane.org; Wed, 29 Oct 2008 07:46:34 +0100 Original-Received: from localhost ([127.0.0.1]:60020 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Kv4o1-0008Jf-DB for ged-emacs-devel@m.gmane.org; Wed, 29 Oct 2008 02:45:25 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Kv4nx-0008Ja-Fm for emacs-devel@gnu.org; Wed, 29 Oct 2008 02:45:21 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Kv4nw-0008I2-0O for emacs-devel@gnu.org; Wed, 29 Oct 2008 02:45:21 -0400 Original-Received: from [199.232.76.173] (port=55612 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Kv4nv-0008Ho-RG for emacs-devel@gnu.org; Wed, 29 Oct 2008 02:45:19 -0400 Original-Received: from mx20.gnu.org ([199.232.41.8]:13030) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Kv4nv-00055Q-9e for emacs-devel@gnu.org; Wed, 29 Oct 2008 02:45:19 -0400 Original-Received: from rcsinet13.oracle.com ([148.87.113.125] helo=rgminet13.oracle.com) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Kv4nu-0001bf-Ep for emacs-devel@gnu.org; Wed, 29 Oct 2008 02:45:18 -0400 Original-Received: from rgminet15.oracle.com (mail-router.oracle.com [148.87.113.117]) by rgminet13.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id m9T6jIJm010882 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 29 Oct 2008 06:45:19 GMT Original-Received: from acsmt707.oracle.com (acsmt707.oracle.com [141.146.40.85]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id m9T6jBWt013099; Wed, 29 Oct 2008 06:45:12 GMT Original-Received: from dradamslap1 (/24.23.165.218) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 29 Oct 2008 06:45:08 +0000 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87hc6wf7u2.fsf@uwakimon.sk.tsukuba.ac.jp> Thread-Index: Ack5bl3SReS44pazQwWvGnczXbZJ+AAHTcpQ X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Source-IP: acsmt707.oracle.com [141.146.40.85] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090208.49080676.02F1:SCFSTAT928724,ss=1,fgs=0 X-detected-kernel: by mx20.gnu.org: Linux 2.6 (newer, 1) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) 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: news.gmane.org gmane.emacs.devel:105129 Archived-At: > normally long values will either be indirect (eg, the value of > variable whose name can be used instead of the value), or they will be > compounds in which case a compound widget will be used so that the > components can be changed. "Normally", no. Typically, yes. But even variable and function names can be long enough to encumber a menu item as an annotation. And then there are long string values (regexps, fonts), sometimes multi-line. And long sexps (e.g. lambdas). And tags themselves can be long. A glance at existing defcustoms in the elisp dir shows that. Most values are short, but some are not. Take a look at option `align-rules-list', for example. Though compound, many of its components are very long regexps or lambdas (e.g. over 300 chars). It's not your average defcustom, but it's by no means abnormal either. Nevertheless, adding short values to the menu items, next to the tags, is a good start - certainly better than offering users no correspondence at all. Practice will then show whether it proves satisfactory. Come to think of it, the value-vs-tag confusion is really a problem only for symbol-valued `const' values anyway, for the most part. So adding the value annotations only for symbol `const' values (in a `choice') would probably not be too bad a solution. Only the occasional long symbol name plus long tag name would be problematic.