From: Andrew Sullivan <ajs@crankycanuck.ca>
To: pgsql-hackers@postgresql.org
Subject: Re: "May", "can", "might"
Date: Fri, 2 Feb 2007 11:46:38 -0500
Message-ID: <20070202164638.GB11505@phlogiston.dyndns.org> (raw)
In-Reply-To: <200701301739.l0UHdQS05488@momjian.us>
References: <200701301739.l0UHdQS05488@momjian.us>
On Tue, Jan 30, 2007 at 12:39:26PM -0500, Bruce Momjian wrote:
> I would like to clean up our documentation to consistently use these
> words. Objections?
None here, but if you're going to go to the trouble, you might want
to have a look at how others have faced this problem too.
In my line of work, we've taken to adopting the RFC 2119 words for
cases where we want to be super-clear and unambiguous. I don't think
those formulations would be much use for user manuals, but it's nice
to see that another group of people who work by converging on
consensus can still do that by (for example) agreeing that "MAY" and
"may" are not the same word.
A
--
Andrew Sullivan | ajs@crankycanuck.ca
The whole tendency of modern prose is away from concreteness.
--George Orwell
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients from your mail client; the link fills in
the headers below: reply via email
Some clients, webmail especially, drop In-Reply-To and References from
a link, and the reply then starts a new thread: use the mbox below.
To: pgsql-docs@postgresql.org
Cc: ajs@crankycanuck.ca, pgsql-hackers@postgresql.org
Subject: Re: "May", "can", "might"
In-Reply-To: <20070202164638.GB11505@phlogiston.dyndns.org>
References: <200701301739.l0UHdQS05488@momjian.us> <20070202164638.GB11505@phlogiston.dyndns.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox