pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
Cc: pgsql-committers@lists.postgresql.org
Subject: Re: pgsql: doc: use simpler language for NULL return from ANY/ALL
Date: Fri, 02 Nov 2018 10:20:21 -0400
Message-ID: <17406.1541168421@sss.pgh.pa.us> (raw)
In-Reply-To: <E1gIYyQ-00043H-Us@gemulon.postgresql.org>
References: <E1gIYyQ-00043H-Us@gemulon.postgresql.org>

Bruce Momjian <bruce@momjian.us> writes:
> doc:  use simpler language for NULL return from ANY/ALL
> Previously the combination of "does not return" and "any row" caused
> ambiguity.

IMO this is not an improvement.  It's turned something that read
reasonably well into something that sounds like it was written by
a not very good speaker of English.  In particular, the lack of
grammatical matching between the two parts of the sentence is now
quite confusing:

    The result is NULL if no comparison with a subquery row returns true,
    and it returns NULL for at least one row.

The antecedent of "it" was clear before, and is not now, at least to me.

Maybe you could replace that clause with "..., and at least one comparison
returns NULL."

			regards, tom lane




view thread (9+ messages)  latest in thread

Message-ID: <17406.1541168421@sss.pgh.pa.us>
Permalink:  ../17406.1541168421@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/17406.1541168421@sss.pgh.pa.us

 · 

reply

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 using the --to and --cc options:
  reply via email

  To: pgsql-committers@postgresql.org
  Cc: tgl@sss.pgh.pa.us, bruce@momjian.us, pgsql-committers@lists.postgresql.org
  Subject: Re: pgsql: doc: use simpler language for NULL return from ANY/ALL
  In-Reply-To: <17406.1541168421@sss.pgh.pa.us>

* 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