From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#2792: 23.0.90; doc string of switch-to-buffer Date: Thu, 26 Mar 2009 18:02:36 -0700 Message-ID: <000d01c9ae77$b8452410$0200a8c0@us.oracle.com> References: <005e01c9ae52$e88a0340$c2b22382@us.oracle.com> Reply-To: Drew Adams , 2792@emacsbugs.donarmstrong.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 1238117046 3742 80.91.229.12 (27 Mar 2009 01:24:06 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 27 Mar 2009 01:24:06 +0000 (UTC) Cc: emacs-pretest-bug@gnu.org, 2792@emacsbugs.donarmstrong.com To: "'Stefan Monnier'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Mar 27 02:25:23 2009 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.50) id 1Ln0p1-0000dt-0Y for geb-bug-gnu-emacs@m.gmane.org; Fri, 27 Mar 2009 02:25:23 +0100 Original-Received: from localhost ([127.0.0.1]:43623 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Ln0nd-0006CE-Sp for geb-bug-gnu-emacs@m.gmane.org; Thu, 26 Mar 2009 21:23:57 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Ln0nZ-0006Ba-My for bug-gnu-emacs@gnu.org; Thu, 26 Mar 2009 21:23:53 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Ln0nV-00064b-3b for bug-gnu-emacs@gnu.org; Thu, 26 Mar 2009 21:23:53 -0400 Original-Received: from [199.232.76.173] (port=50828 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Ln0nU-00064Q-UF for bug-gnu-emacs@gnu.org; Thu, 26 Mar 2009 21:23:48 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:60820) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Ln0nU-0007nq-Co for bug-gnu-emacs@gnu.org; Thu, 26 Mar 2009 21:23:48 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n2R1NjdB010559; Thu, 26 Mar 2009 18:23:45 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id n2R1A8fe007165; Thu, 26 Mar 2009 18:10:08 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Fri, 27 Mar 2009 01:10:08 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 2792 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by 2792-submit@emacsbugs.donarmstrong.com id=B2792.12381157714536 (code B ref 2792); Fri, 27 Mar 2009 01:10:08 +0000 Original-Received: (at 2792) by emacsbugs.donarmstrong.com; 27 Mar 2009 01:02:51 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from acsinet12.oracle.com (acsinet12.oracle.com [141.146.126.234]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n2R12nNV004515 for <2792@emacsbugs.donarmstrong.com>; Thu, 26 Mar 2009 18:02:50 -0700 Original-Received: from acsinet13.oracle.com (acsinet13.oracle.com [141.146.126.235]) by acsinet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n2R12Id9032240 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 27 Mar 2009 01:02:19 GMT Original-Received: from acsmt704.oracle.com (acsmt704.oracle.com [141.146.40.82]) by acsinet13.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n2R130N9025476; Fri, 27 Mar 2009 01:03:02 GMT Original-Received: from dradamslap1 (/24.4.133.20) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 27 Mar 2009 01:02:38 +0000 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 Thread-Index: AcmucmrqpD5GIFnJS8us6MkM5aqpLQAAwbVgAABZHuA= X-Source-IP: acsmt704.oracle.com [141.146.40.82] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A010207.49CC25B0.00AC:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Thu, 26 Mar 2009 21:23:53 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list 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:26654 gmane.emacs.pretest.bugs:24184 Archived-At: > > > Get rid of the word "WARNING" in the doc string. This is > > > just helpful information, not a warning. Warnings are for > > > things that are inherently dangerous. > > > > It's inherently dangerous, in the sense that if I see a call to > > `switch-to-buffer' in some Elisp code, I know it's a bug > > (the counter examples are so rare they're not worth mentioning). > > No, danger has nothing to do with this. > > Knowing that something is a bug is not knowing that there is > a danger. A bug does not imply danger. Using "WARNING" for > something that is not a warning dilutes its meaning. > > Use stronger language, if you like. Say, even, that it is > most likely a bug to use it in Lisp code (or even a > "****BUG!!!!****", if you're really so inclined). But don't > use "WARNING". > > Use "WARNING" when you know that it is used in code that > controls trains on the same track or nuclear missiles or > anthrax tests. ;-) Oh, BTW. Such diluted WARNINGs apparently do little good. That particular "WARNING" has been in Emacs since at least Emacs 20, yet there are over 600 grep hits for `switch-to-buffer' in the distributed Emacs 23 Lisp code. So much for the Chicken Little approach.