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: Document option tool-bar-mode Date: Sat, 17 Dec 2005 21:57:46 -0800 Organization: Newt Software Message-ID: <26173.1134885466@olgas.newt.com> References: <22534.1134868813@olgas.newt.com> <200512180258.jBI2wrO21007@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1134885522 23323 80.91.229.2 (18 Dec 2005 05:58:42 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 18 Dec 2005 05:58:42 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 18 06:58:33 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EnrYf-0005Xu-Op for ged-emacs-devel@m.gmane.org; Sun, 18 Dec 2005 06:58:10 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EnrZR-0005Gq-Ll for ged-emacs-devel@m.gmane.org; Sun, 18 Dec 2005 00:58:57 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EnrZE-0005G3-HR for emacs-devel@gnu.org; Sun, 18 Dec 2005 00:58:44 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EnrZC-0005FU-Rg for emacs-devel@gnu.org; Sun, 18 Dec 2005 00:58:44 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EnrZC-0005FQ-P8 for emacs-devel@gnu.org; Sun, 18 Dec 2005 00:58:42 -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 1Enrbv-0003p7-J2 for emacs-devel@gnu.org; Sun, 18 Dec 2005 01:01:31 -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 1EnrYJ-0004Ec-00; Sun, 18 Dec 2005 00:57:47 -0500 Original-Received: by olgas.newt.com (Postfix, from userid 1000) id EF6AA16FE1; Sat, 17 Dec 2005 21:57:46 -0800 (PST) Original-Received: from olgas.newt.com (localhost [127.0.0.1]) by olgas.newt.com (Postfix) with ESMTP id EBE3516FD8; Sat, 17 Dec 2005 21:57:46 -0800 (PST) Original-To: Luc Teirlinck In-Reply-To: Luc Teirlinck's message of Sat, 17 Dec 2005 20:58:53 CST. <200512180258.jBI2wrO21007@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 Mail-Followup-To: emacs-devel@gnu.org 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:47982 Archived-At: Luc Teirlinck wrote: > Bill Wohler wrote: > > You can turn display of tool bars on or off with @kbd{M-x > -tool-bar-mode}. > +tool-bar-mode} or by customizing the option @samp{tool-bar-mode}. > > The two things above are described as equivalent, but they are not. > The first is strictly for the current session, the second is usually > meant to be permanent. It is @code{tool-bar-mode}, not @samp. Thanks. > `customizing' is ambiguous. It does not consistently refer to the > Customize interface, but is often used in a more general sense. Perhaps we should not do that. "Customizing the option foo" is much cleaner than "saving the variable foo through the Customize interface." > I prefer the following patch, where the word `variable' still could be > replaced by `option', depending on what we decide in another > discussion. It only talks about turning toolbars _off_ permanently, > because they are enabled by default in all situations where they make > sense. > > You can turn display of tool bars on or off with @kbd{M-x > tool-bar-mode}. You can turn tool bars permanently off by putting the > line @code{(tool-bar-mode 0)} in your @file{.emacs} file, or by saving > the variable @code{tool-bar-mode} through the Customize interface. A couple of small grammar tweaks: You can turn display of tool bars on or off with @kbd{M-x tool-bar-mode}. You can turn tool bars off permanently by putting the line @code{(tool-bar-mode 0)} in your @file{.emacs} file, or by setting and saving the variable @code{tool-bar-mode} through the Customize interface. I still think that "customizing the option @code{tool-bar-mode}" is much better. -- 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.