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: Wed, 29 Oct 2008 09:08:27 -0700 Message-ID: <000601c939e0$9422dca0$c2b22382@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><007e01c93991$e714c8f0$0200a8c0@us.oracle.com> 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 1225296689 24709 80.91.229.12 (29 Oct 2008 16:11:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 29 Oct 2008 16:11:29 +0000 (UTC) Cc: 'martin rudalics' , "'Stephen J. Turnbull'" , emacs-devel@gnu.org To: "'Stefan Monnier'" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Oct 29 17:12:29 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 1KvDct-0007rM-HA for ged-emacs-devel@m.gmane.org; Wed, 29 Oct 2008 17:10:32 +0100 Original-Received: from localhost ([127.0.0.1]:59596 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KvDbm-0008Th-OE for ged-emacs-devel@m.gmane.org; Wed, 29 Oct 2008 12:09:22 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KvDbK-0008Gf-9h for emacs-devel@gnu.org; Wed, 29 Oct 2008 12:08:54 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KvDbG-0008FU-OM for emacs-devel@gnu.org; Wed, 29 Oct 2008 12:08:54 -0400 Original-Received: from [199.232.76.173] (port=39788 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KvDbG-0008FP-Jd for emacs-devel@gnu.org; Wed, 29 Oct 2008 12:08:50 -0400 Original-Received: from agminet01.oracle.com ([141.146.126.228]:39977) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KvDbF-0003dp-O3 for emacs-devel@gnu.org; Wed, 29 Oct 2008 12:08:50 -0400 Original-Received: from agmgw1.us.oracle.com (agmgw1.us.oracle.com [152.68.180.212]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id m9TG8Sn7029191; Wed, 29 Oct 2008 11:08:28 -0500 Original-Received: from acsmt702.oracle.com (acsmt702.oracle.com [141.146.40.80]) by agmgw1.us.oracle.com (Switch-3.2.0/Switch-3.2.0) with ESMTP id m9TG8RxR030864; Wed, 29 Oct 2008 10:08:28 -0600 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 29 Oct 2008 16:08:27 +0000 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Ack5093eKo0WTP4+QymMPkzEDNWlcAACs05Q X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.4-2.6 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:105150 Archived-At: > I think we should just add the value to the menu, together with some > sanity check: if the printed representation of the value is too long, > then shorten it by replacing the middle chars with "...", and let the > code provide an override for those few remaining cases where it's > not satisfactory. That's the abbreviating I suggested. But I'd recommend eliding the terminal chars, not the middle ones. In the case of a sexp, the normal elision should be used (e.g. via `print-length') - such as is used in *Backtrace*, but more abbreviated. But don't you agree that we need really to provide the value only when it is a symbol-valued `const' in a `choice'? I think those are about the only cases where a doc string's reference to a value might lead to confusion wrt the Customize tags. If so, then there is no need to worry about sexps and strings and such. It is only the occasional long symbol name that would need to be abbreviated (at its end, not middle).