Skip site navigation (1) Skip section navigation (2)

Re: "May", "can", "might"

From: Andrew Sullivan <ajs(at)crankycanuck(dot)ca>
To: pgsql-hackers(at)postgresql(dot)org
Subject: Re: "May", "can", "might"
Date: 2007-02-02 16:46:38
Message-ID: 20070202164638.GB11505@phlogiston.dyndns.org (view raw or flat)
Thread:
Lists: pgsql-docspgsql-hackers
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(at)crankycanuck(dot)ca
The whole tendency of modern prose is away from concreteness.
		--George Orwell

In response to

pgsql-docs by date

Next:From: Bruce MomjianDate: 2007-02-04 01:27:43
Subject: Re: create index concurrently docs ...
Previous:From: Bruce MomjianDate: 2007-02-01 21:03:27
Subject: File system replication and DRBD

pgsql-hackers by date

Next:From: Pavel StehuleDate: 2007-02-02 16:53:26
Subject: Re: proposal: only superuser can change customized_options
Previous:From: Tom LaneDate: 2007-02-02 16:40:10
Subject: Re: proposal: only superuser can change customized_options

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group