From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7465: 24.0.50; transient-mark-mode customization UI is confusing Date: Mon, 22 Nov 2010 08:15:00 -0800 Message-ID: <4A6EC880811E4A759A6B050E7ABFE3E6@us.oracle.com> References: <8739qtl6yi.fsf@escher.home> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1290444305 32034 80.91.229.12 (22 Nov 2010 16:45:05 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 22 Nov 2010 16:45:05 +0000 (UTC) To: "'Stephen Berman'" , <7465@debbugs.gnu.org> Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Nov 22 17:45:00 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PKZVk-0003YN-Eg for geb-bug-gnu-emacs@m.gmane.org; Mon, 22 Nov 2010 17:45:00 +0100 Original-Received: from localhost ([127.0.0.1]:55080 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PKZVj-0000Dw-QB for geb-bug-gnu-emacs@m.gmane.org; Mon, 22 Nov 2010 11:44:59 -0500 Original-Received: from [140.186.70.92] (port=60260 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PKZVP-000056-BL for bug-gnu-emacs@gnu.org; Mon, 22 Nov 2010 11:44:48 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PKZVJ-0000y6-AE for bug-gnu-emacs@gnu.org; Mon, 22 Nov 2010 11:44:39 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:52460) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PKZVJ-0000y1-7M for bug-gnu-emacs@gnu.org; Mon, 22 Nov 2010 11:44:33 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PKYzq-000756-Dg; Mon, 22 Nov 2010 11:12:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 22 Nov 2010 16:12:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 7465 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 7465-submit@debbugs.gnu.org id=B7465.129044228427213 (code B ref 7465); Mon, 22 Nov 2010 16:12:02 +0000 Original-Received: (at 7465) by debbugs.gnu.org; 22 Nov 2010 16:11:24 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PKYzD-00074s-Pn for submit@debbugs.gnu.org; Mon, 22 Nov 2010 11:11:24 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PKYzB-00074n-EM for 7465@debbugs.gnu.org; Mon, 22 Nov 2010 11:11:21 -0500 Original-Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id oAMGGZVi032512 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 22 Nov 2010 16:16:36 GMT Original-Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id oAMGGXLl003795; Mon, 22 Nov 2010 16:16:35 GMT Original-Received: from abhmt001.oracle.com by acsmt353.oracle.com with ESMTP id 801734361290442501; Mon, 22 Nov 2010 08:15:01 -0800 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 22 Nov 2010 08:15:00 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <8739qtl6yi.fsf@escher.home> Thread-Index: AcuKXaqphGoT+FTXSBe3UQLhXGYhXAAAbnvQ X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Mon, 22 Nov 2010 11:12:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:41819 Archived-At: > The complete text of the doc string is displayed, as usual, > but here it is confusing, because the values `lambda' and > `(only . OLDVAL)' cannot be entered, since only toggling > on-off is allowed. As noted in the Elisp manual, these > values are intended for Lisp programs, so they should not > be mentioned in the Custom interface, which is concerned with > user settings. Users, even users of Customize, can also use Emacs Lisp. The complete doc string should always be available in Customize, and the Lisp interface should be described in the doc string (not just the Customize interface). However, you have a point in that the Lisp description is not identified as such here, so this text can indeed be confusing to users. The correct fix is to introduce the description of the Lisp values by saying that these are the values used in Lisp code. Also, the text should not say that "non-nil _also_ enables highlighting...", for this highlighting is a big part of what t-m mode is all about. Please remove "also" here.