[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

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
> +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.

.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

reply via email to

[Prev in Thread] Current Thread [Next in Thread]