From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Bill Wohler Newsgroups: gmane.emacs.devel Subject: Re: toolbar conventions Date: Sat, 17 Dec 2005 12:52:37 -0800 Organization: Newt Software Message-ID: <18115.1134852757@olgas.newt.com> References: <19466.1134769009@olgas.newt.com> <200512172022.jBHKMuw15652@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1134852887 11205 80.91.229.2 (17 Dec 2005 20:54:47 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 17 Dec 2005 20:54:47 +0000 (UTC) Cc: rms@gnu.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 17 21:54:44 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Enj35-0004Xo-VU for ged-emacs-devel@m.gmane.org; Sat, 17 Dec 2005 21:53:00 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Enj3r-0003in-7D for ged-emacs-devel@m.gmane.org; Sat, 17 Dec 2005 15:53:47 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Enj3h-0003iY-VX for emacs-devel@gnu.org; Sat, 17 Dec 2005 15:53:38 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Enj3h-0003iM-8Y for emacs-devel@gnu.org; Sat, 17 Dec 2005 15:53:37 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Enj3h-0003iJ-22 for emacs-devel@gnu.org; Sat, 17 Dec 2005 15:53:37 -0500 Original-Received: from [207.69.195.66] (helo=pop-canoe.atl.sa.earthlink.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1Enj6K-00073f-UB; Sat, 17 Dec 2005 15:56:21 -0500 Original-Received: from h-68-165-7-242.snvacaid.dynamic.covad.net ([68.165.7.242] helo=olgas.newt.com) by pop-canoe.atl.sa.earthlink.net with esmtp (Exim 3.36 #10) id 1Enj2k-00009K-00; Sat, 17 Dec 2005 15:52:38 -0500 Original-Received: by olgas.newt.com (Postfix, from userid 1000) id DEED116FE1; Sat, 17 Dec 2005 12:52:37 -0800 (PST) Original-Received: from olgas.newt.com (localhost [127.0.0.1]) by olgas.newt.com (Postfix) with ESMTP id DAE8316FAC; Sat, 17 Dec 2005 12:52:37 -0800 (PST) Original-To: Luc Teirlinck In-Reply-To: Luc Teirlinck's message of Sat, 17 Dec 2005 14:22:56 CST. <200512172022.jBHKMuw15652@raven.dms.auburn.edu> X-Mailer: MH-E 7.85+cvs; nmh 1.1; GNU Emacs 22.0.50.10 X-Image-URL: http://www.newt.com/wohler/images/bill-diving.png 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:47964 Archived-At: I have been using "option" in the MH-E manual (125 pages and growing) and code (21k lines) to refer to anything you can customize. I've been using "variable" for the remaining variables that must be set with setq. My rationale was that I wanted to differentiate variables that were customizable. In addition, both customize-option and customize-variable have "Customize option:" as the prompt (not "Customize user option variable:"). At the time I started this convention, I was unaware of the term "user option." However, with my usage, "user option" is redundant. I haven't looked recently to see the usage trends. But I think my terminology is clean and unambiguous. Note that I haven't quite got around to documenting faces. I'm not sure if it makes sense or not to refer to them as options. If we do, then we need to modify customize-option to accept a face and pass it off to customize-face (maybe we should do that anyway). It feels like I'll be calling them faces, but I haven't thought about how you would distinguish between faces that can be customized and those that cannot. I'll be getting to that chapter in about a week and provide more visceral feedback then. Thoughts? -- Bill Wohler http://www.newt.com/wohler/ GnuPG ID:610BD9AD Maintainer of comp.mail.mh FAQ and MH-E. Vote Libertarian! If you're passed on the right, you're in the wrong lane.