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: defcustom and the stars. Date: Thu, 4 Jan 2007 09:08:04 -0800 Message-ID: References: <877iw3tfc4.fsf@lrde.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable X-Trace: sea.gmane.org 1167930703 24791 80.91.229.12 (4 Jan 2007 17:11:43 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 4 Jan 2007 17:11:43 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 04 18:11:41 2007 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 1H2W7r-0003Pe-1t for ged-emacs-devel@m.gmane.org; Thu, 04 Jan 2007 18:11:35 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H2W7q-0006Qj-9y for ged-emacs-devel@m.gmane.org; Thu, 04 Jan 2007 12:11:34 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1H2W6V-0004on-4m for emacs-devel@gnu.org; Thu, 04 Jan 2007 12:10:11 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1H2W6S-0004l6-Ag for emacs-devel@gnu.org; Thu, 04 Jan 2007 12:10:10 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H2W6S-0004kr-3e for emacs-devel@gnu.org; Thu, 04 Jan 2007 12:10:08 -0500 Original-Received: from [141.146.126.228] (helo=agminet01.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA:32) (Exim 4.52) id 1H2W6R-0004SR-Iz for emacs-devel@gnu.org; Thu, 04 Jan 2007 12:10:07 -0500 Original-Received: from rgmgw2.us.oracle.com (rgmgw2.us.oracle.com [138.1.186.111]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id l04HA4kt011145 for ; Thu, 4 Jan 2007 11:10:05 -0600 Original-Received: from rcsmt251.oracle.com (rcsmt251.oracle.com [148.87.90.196]) by rgmgw2.us.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id l04GhZNc018223 for ; Thu, 4 Jan 2007 10:10:02 -0700 Original-Received: from dhcp-4op11-4op12-west-130-35-178-179.us.oracle.com by rcsmt250.oracle.com with ESMTP id 2335166741167930490; Thu, 04 Jan 2007 10:08:10 -0700 Original-To: X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) In-Reply-To: <877iw3tfc4.fsf@lrde.org> X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3028 Importance: Normal X-Whitelist: TRUE X-Whitelist: TRUE X-Brightmail-Tracker: AAAAAQAAAAI= X-MIME-Autoconverted: from 8bit to quoted-printable by agminet01.oracle.com id l04HA4kt011145 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:64755 Archived-At: > Again, it is with the previous patch. With it, not only =AB You can > customize the variable =BB can appear, but also =AB You can change at u= ser > level the variable =BB, which means that you can M-x set-var this var. If that's what you mean, then that's what should be said: "You can use command `set-variable' to change the value". This is confusing: "change a= t user level". > | You can change at user level this variable. > =AB change =BB is a hyperlink. Following it is the same as > M-x set-variable I'd rather we just mentioned `set-variable' explicitly, to teach about it. No need to use `C-h v' each time if you know you want to change the value and you know about `set-variable'. "You can change at user level" doesn't teach anything. It says less (beca= use it is confusing) than just "You can change this variable" (with a link on "change"). It's actually the value that is changed, so "You can change the value" is better, but still not as good as "You can use command `set-variable' to change the value".