* bug#2792: 23.0.90; doc string of switch-to-buffer
@ 2009-03-26 20:39 Drew Adams
2009-03-27 0:23 ` Stefan Monnier
0 siblings, 1 reply; 4+ messages in thread
From: Drew Adams @ 2009-03-26 20:39 UTC (permalink / raw)
To: emacs-pretest-bug
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.
In GNU Emacs 23.0.90.1 (i386-mingw-nt5.1.2600)
of 2009-02-01 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#2792: 23.0.90; doc string of switch-to-buffer
2009-03-26 20:39 bug#2792: 23.0.90; doc string of switch-to-buffer Drew Adams
@ 2009-03-27 0:23 ` Stefan Monnier
2009-03-27 0:53 ` Drew Adams
2009-03-27 1:02 ` Drew Adams
0 siblings, 2 replies; 4+ messages in thread
From: Stefan Monnier @ 2009-03-27 0:23 UTC (permalink / raw)
To: Drew Adams; +Cc: emacs-pretest-bug, 2792
> 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).
Stefan
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#2792: 23.0.90; doc string of switch-to-buffer
2009-03-27 0:23 ` Stefan Monnier
@ 2009-03-27 0:53 ` Drew Adams
2009-03-27 1:02 ` Drew Adams
1 sibling, 0 replies; 4+ messages in thread
From: Drew Adams @ 2009-03-27 0:53 UTC (permalink / raw)
To: 'Stefan Monnier'; +Cc: emacs-pretest-bug, 2792
> From: Stefan Monnier Sent: Thursday, March 26, 2009 5:23 PM
> > 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. ;-)
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#2792: 23.0.90; doc string of switch-to-buffer
2009-03-27 0:23 ` Stefan Monnier
2009-03-27 0:53 ` Drew Adams
@ 2009-03-27 1:02 ` Drew Adams
1 sibling, 0 replies; 4+ messages in thread
From: Drew Adams @ 2009-03-27 1:02 UTC (permalink / raw)
To: 'Stefan Monnier'; +Cc: emacs-pretest-bug, 2792
> > > 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.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2009-03-27 1:02 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-03-26 20:39 bug#2792: 23.0.90; doc string of switch-to-buffer Drew Adams
2009-03-27 0:23 ` Stefan Monnier
2009-03-27 0:53 ` Drew Adams
2009-03-27 1:02 ` Drew Adams
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).