[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
RE: typo in frame.el
From: |
Drew Adams |
Subject: |
RE: typo in frame.el |
Date: |
Fri, 9 Apr 2004 13:05:13 -0700 |
Doc strings, at least their first lines, need to be short and clear, so
"iff" is in fact helpful - but only if the convention is understood.
Instead of not taking advantage of the convention, why don't we include an
explanation of it in the general doc: add a line stating what "iff" means to
the Emacs (or Elisp) doc?
At the very worst, someone unacquainted with the meaning of "iff" will
likely interpret it as "if" (and as an benign typo), so there is no harm
done in using it: (the most important) half of its meaning is always
conveyed.
Another possibility is to use "<=>" (and "=>" for "implies"), but I suppose
that assumes some familiarity with symbolic logic or math.
- Drew
-----Original Message-----
From: address@hidden
[mailto:address@hidden Behalf Of
Alex Schroeder
Sent: Friday, April 09, 2004 11:58 AM
To: Hiroshi Fujishima
Cc: address@hidden
Subject: Re: typo in frame.el
Hiroshi Fujishima <address@hidden> writes:
> -With a numeric argument, turn blinking cursor mode on iff ARG is
positive.
> +With a numeric argument, turn blinking cursor mode on if ARG is positive.
For mathematicians, "iff" is an abbreviation for "if and only
if"... So it is not a typo, I suppose. I think that should avoid the
use of such abbreviations in Emacs documentation, however, since not
all our users come from an English/science background.
Alex.
--
.O. http://www.emacswiki.org/alex/
..O Schroeder's fourth law:
OOO None of your friends and coworkers share your taste in music.
_______________________________________________
Emacs-devel mailing list
address@hidden
http://mail.gnu.org/mailman/listinfo/emacs-devel
- typo in frame.el, Hiroshi Fujishima, 2004/04/09
- Re: typo in frame.el, David Kastrup, 2004/04/09
- Re: typo in frame.el, Alex Schroeder, 2004/04/09
- RE: typo in frame.el,
Drew Adams <=
- Re: typo in frame.el, Simon Josefsson, 2004/04/09
- RE: typo in frame.el, Drew Adams, 2004/04/09
- Re: typo in frame.el, David Kastrup, 2004/04/09
- Re: typo in frame.el, Simon Josefsson, 2004/04/09
- RE: typo in frame.el, Drew Adams, 2004/04/09
- Re: typo in frame.el, David Kastrup, 2004/04/09
- RE: typo in frame.el, Drew Adams, 2004/04/09
- Re: typo in frame.el, David Kastrup, 2004/04/09
- Re: typo in frame.el, Juri Linkov, 2004/04/11
- Re: typo in frame.el, Alan Shutko, 2004/04/09