unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
Subject: RE: typo in frame.el
Date: Fri, 9 Apr 2004 13:46:53 -0700	[thread overview]
Message-ID: <FDELKNEBLPKKDCEBEJCBGEFMCDAA.drew.adams@oracle.com> (raw)
In-Reply-To: <iluoeq0gavp.fsf@latte.josefsson.org>

How about we use "<=>", conventionally, in doc strings, but we also explain
this convention in the Emacs manual, for those who have never seen it? If we
adopt such a convention, then we should perhaps also conventionally use "=>"
for "implies" ("only if") and "<=" for "if".

(If you don't enjoy semantic nitpicking, hit the delete key now.)

In "precisely when", the key word, which makes it equivalent to "iff", is
"precisely". If you drop it, then you're back to just "if": "when", by
itself, means just "if" - that is:

  "a when b" <=> "a if b" <=> "b only if a" <=> "if b then a"

I think "iff" is much more common, in English technical writing, than
"precisely when". ("<=>" is more common than "iff" in math: it is not tied
to a natural language.)

Also, it is fairly common in programming to use "when" to indicate one or
both of these (as opposed to just logical implication):

 - temporal relation ("at the same time as")
 - condition for a temporal sequence of actions/events

For example, in Common Lisp, "when" is used stylistically to introduce a
conditional sequence of actions (with side effects).

 - Drew

-----Original Message-----
From: emacs-devel-bounces+drew.adams=oracle.com@gnu.org
[mailto:emacs-devel-bounces+drew.adams=oracle.com@gnu.org]On Behalf Of
Simon Josefsson
Sent: Friday, April 09, 2004 1:22 PM
To: emacs-devel@gnu.org
Subject: Re: typo in frame.el


Alex Schroeder <alex@emacswiki.org> writes:

> Hiroshi Fujishima <pooh@nature.tsukuba.ac.jp> 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.

I prefer "precisely when" instead of "if and only if".  Sometimes,
even the "precisely" can be omitted.  Less technobabbly.  Alas,
changing "iff" into "when" can make a documentation string line too
long.  Confusion regarding "iff" is a reoccurring theme, so it might
make sense to do something about it.

(Kudos to my algebra professor, who introduced me to p.w., although
only for Swedish.  But I think it works as well in English.  Any
native speaker who disagree?)



_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/emacs-devel

  reply	other threads:[~2004-04-09 20:46 UTC|newest]

Thread overview: 17+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2004-04-09 10:20 typo in frame.el Hiroshi Fujishima
2004-04-09 10:56 ` David Kastrup
2004-04-09 18:58 ` Alex Schroeder
2004-04-09 20:05   ` Drew Adams
2004-04-09 20:22   ` Simon Josefsson
2004-04-09 20:46     ` Drew Adams [this message]
2004-04-09 21:11       ` David Kastrup
2004-04-09 21:33         ` Simon Josefsson
2004-04-09 21:57         ` Drew Adams
2004-04-09 22:37           ` David Kastrup
2004-04-09 23:03             ` Drew Adams
2004-04-09 23:17               ` David Kastrup
2004-04-10 22:54             ` Juri Linkov
2004-04-09 22:47           ` Alan Shutko
2004-04-09 23:17             ` Alfred M. Szmidt
2004-04-10  1:03       ` Miles Bader
2004-04-11  2:35     ` Richard Stallman

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=FDELKNEBLPKKDCEBEJCBGEFMCDAA.drew.adams@oracle.com \
    --to=drew.adams@oracle.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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).