all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
To: <emacs-devel@gnu.org>
Subject: RE: typo in accept-process-output (process.c)
Date: Tue, 7 Aug 2007 10:33:06 -0700	[thread overview]
Message-ID: <BNELLINCGFJLDJIKDGACMEEHCBAA.drew.adams@oracle.com> (raw)
In-Reply-To: <jwv8x8nmhfp.fsf-monnier+emacs@gnu.org>

> I think a better approach is to keep using `iff' (also known as `ssi' in
> French), but to make it such that the user can click on it to get to the
> Glossary where we add an entry for it.
> We could later on use the same feature for some other terms (e.g.
> "fringe").

I agree. It is better to avoid varying the terminology for things like
this - using different terms for the same thing in different places (e.g. by
different authors). It is best to use a term such as "iff" consistently, and
define it clearly.

The meaning of "if" can vary in informal English, and different people
sometimes understand it differently. In more formal use, these are often
used as synonyms: "A implies B", "if A then B", "A only if B", "B if A", "B
whenever A", and "B provided A". And these are used as synonyms: "A if and
only if B", and "A is equivalent to B".

The problem with using "iff" is that some readers will not notice that it is
not "if", or they might think that it is a typo. If we use "iff" as Stefan
suggested, then it is important that users have a _visual_ clue that this is
a glossary term and that they can click it to see its definition. That
visual clue would be enough to signal that this is not just "if" or a typo.

Until we have such a glossary-term indicator, we should use "if and only if"
(or we could temporarily take the risk of misunderstanding and use "iff").
It is not appropriate for us to use "if" (or "only if") in place of "iff",
when the meaning of the latter is important to the context.

This is so, in spite of the fact that, as Jason pointed out, many readers
assume bidirectionality for "if"; that is, they do not distinguish "if" from
"if and only if".

In some cases, of course, the "if" direction is of primary importance, and
the "only if" case can be ignored or glossed over in the doc. That is, when
it makes little difference whether readers confuse "if" with "iff", we could
get away with using just "if". Still, in general it is better to clearly
state what happens in each case or, if they are equivalent, to use "iff" (or
"if and only if").

Because careful use of such terms can result in language that is more like a
spec than doc, it is sometimes helpful and appropriate to use both a short,
introductory, informal, easy-to-read description and a more rigorous,
detailed explanation. Those who are interested will take the time to parse
the latter, and the others will generally understand enough to get the job
done.

  reply	other threads:[~2007-08-07 17:33 UTC|newest]

Thread overview: 32+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2007-08-05 12:04 typo in accept-process-output (process.c) Dieter Wilhelm
2007-08-05 12:21 ` David Kastrup
2007-08-05 20:01   ` Glenn Morris
2007-08-05 22:54     ` Dieter Wilhelm
2007-08-06  0:06       ` Nick Roberts
2007-08-06  6:41         ` Dieter Wilhelm
2007-08-06 14:19     ` Richard Stallman
2007-08-06 20:50       ` Michael Olson
2007-08-07 11:02         ` Stephen Berman
2007-08-07 11:18           ` David Kastrup
2007-08-07 11:31         ` Jason Rumney
2007-08-07 16:37           ` Stefan Monnier
2007-08-07 17:33             ` Drew Adams [this message]
2007-08-07 22:01               ` Dieter Wilhelm
2007-08-07 22:17                 ` Lennart Borgman (gmail)
2007-08-07 23:16                   ` Drew Adams
2007-08-08  0:06                     ` Jason Rumney
2007-08-08  0:21                       ` Drew Adams
2007-08-09  0:07                   ` Richard Stallman
2007-08-08  3:06                 ` Eli Zaretskii
2007-08-08  5:50                   ` Dieter Wilhelm
2007-08-08 18:43                     ` Eli Zaretskii
2007-08-08 20:14                       ` David Kastrup
2007-08-08 20:24                       ` Stefan Monnier
2007-08-08 20:27                         ` martin rudalics
2007-08-08 20:53                           ` Stefan Monnier
2007-08-12 20:33                       ` Christian Schlauer
2007-08-12 22:01                         ` Stephen Berman
2007-08-13  5:00                         ` Richard Stallman
2007-08-05 20:54   ` Richard Stallman
2007-08-08  7:54     ` Glenn Morris
2007-08-09  0:07       ` 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

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

  git send-email \
    --in-reply-to=BNELLINCGFJLDJIKDGACMEEHCBAA.drew.adams@oracle.com \
    --to=drew.adams@oracle.com \
    --cc=emacs-devel@gnu.org \
    /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 external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.