Re: Final cleanup of SQL:1999 references

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: pgsql-patches(at)postgresql(dot)org, Simon Riggs <simon(at)2ndquadrant(dot)com>, Neil Conway <neilc(at)samurai(dot)com>
Subject: Re: Final cleanup of SQL:1999 references
Date: 2005-11-01 19:43:35
Message-ID: 27451.1130874215@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-patches

Some time ago, Peter Eisentraut <peter_e(at)gmx(dot)net> wrote:
> Am Mittwoch, 13. Juli 2005 18:01 schrieb Simon Riggs:
>> This doc patch replaces all inappropriate references to SQL:1999 when it
>> is used as if it were the latest (and/or still valid) SQL standard.
>>
>> SQL:2003 is used in its place.

> I don't necessarily consider this search and replace to be appropriate. All
> information for users looking for SQL:1999 compliance information is now
> lost.

Also, there are places where it completely destroyed the meaning, as in
http://developer.postgresql.org/docs/postgres/sql-select.html#AEN48034
(the "Namespace Available to GROUP BY and ORDER BY" subsection), where
the intended distinction between SQL-92 and later versions of the spec
has been obliterated, and the text is now actually self-contradictory.

> Also, phrases like "This is conforming to SQL:2003." give the wrong
> impression that it is not conforming to SQL:1999. I think it would be less
> confusing in these cases to simply write "This is conforming to the SQL
> standard." and then mention in the appendix that we consider SQL:2003 to be
> the baseline.

I agree: we should just say SQL except where there is an intention to
distinguish different versions of the spec, and in that case mention
the earliest spec version for which the particular statement is true.
This convention will not require any future search-and-replaces.

Barring some fairly convincing objections, I am going to undo most of
this patch later this week, and instead do it as Peter suggests.

regards, tom lane

In response to

Responses

Browse pgsql-patches by date

  From Date Subject
Next Message Chris Browne 2005-11-01 19:50:57 Re: slru.c race condition
Previous Message Chris Browne 2005-11-01 19:41:44 Re: slru.c race condition