pg.ddx.io pgsql-committers@postgresql.org mailing list archive
help / color / mirror / Atom feedpgsql: doc: use simpler language for NULL return from ANY/ALL
9+ messages / 2 participants
[nested] [flat]
Commits from this thread:
2018-11-02 a4634b96cc ca49b5ca5a f35187b368 d403ed2acd 72b1af0783 471ae731c1 beceb87259 docs: adjust simpler language for NULL return from ANY/ALL
* pgsql: doc: use simpler language for NULL return from ANY/ALL
@ 2018-11-02 12:54 Bruce Momjian <bruce@momjian.us>
0 siblings, 0 replies; 9+ messages in thread
From: Bruce Momjian @ 2018-11-02 12:54 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: use simpler language for NULL return from ANY/ALL
Previously the combination of "does not return" and "any row" caused
ambiguity.
Reported-by: KES <kes-kes@yandex.ru>
Discussion: https://postgr.es/m/153701242703.22334.1476830122267077397@wrigleys.postgresql.org
Reviewed-by: David G. Johnston
Backpatch-through: 9.3
Branch
------
REL9_4_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/273166af8f73670a3c7efdfb9d45893d5e011dba
Modified Files
--------------
doc/src/sgml/func.sgml | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
^ permalink raw reply [nested|flat] 9+ messages in thread
* pgsql: doc: use simpler language for NULL return from ANY/ALL
@ 2018-11-02 12:54 Bruce Momjian <bruce@momjian.us>
0 siblings, 0 replies; 9+ messages in thread
From: Bruce Momjian @ 2018-11-02 12:54 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: use simpler language for NULL return from ANY/ALL
Previously the combination of "does not return" and "any row" caused
ambiguity.
Reported-by: KES <kes-kes@yandex.ru>
Discussion: https://postgr.es/m/153701242703.22334.1476830122267077397@wrigleys.postgresql.org
Reviewed-by: David G. Johnston
Backpatch-through: 9.3
Branch
------
REL_10_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/b5acaa8bc8dd7f13f7ae1879aea39cef48d7aa3c
Modified Files
--------------
doc/src/sgml/func.sgml | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
^ permalink raw reply [nested|flat] 9+ messages in thread
* pgsql: doc: use simpler language for NULL return from ANY/ALL
@ 2018-11-02 12:54 Bruce Momjian <bruce@momjian.us>
0 siblings, 1 reply; 9+ messages in thread
From: Bruce Momjian @ 2018-11-02 12:54 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: use simpler language for NULL return from ANY/ALL
Previously the combination of "does not return" and "any row" caused
ambiguity.
Reported-by: KES <kes-kes@yandex.ru>
Discussion: https://postgr.es/m/153701242703.22334.1476830122267077397@wrigleys.postgresql.org
Reviewed-by: David G. Johnston
Backpatch-through: 9.3
Branch
------
master
Details
-------
https://git.postgresql.org/pg/commitdiff/8610c973ddf1cbf0befc1369d2cf0d56c0efcd0a
Modified Files
--------------
doc/src/sgml/func.sgml | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
^ permalink raw reply [nested|flat] 9+ messages in thread
* pgsql: doc: use simpler language for NULL return from ANY/ALL
@ 2018-11-02 12:54 Bruce Momjian <bruce@momjian.us>
0 siblings, 0 replies; 9+ messages in thread
From: Bruce Momjian @ 2018-11-02 12:54 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: use simpler language for NULL return from ANY/ALL
Previously the combination of "does not return" and "any row" caused
ambiguity.
Reported-by: KES <kes-kes@yandex.ru>
Discussion: https://postgr.es/m/153701242703.22334.1476830122267077397@wrigleys.postgresql.org
Reviewed-by: David G. Johnston
Backpatch-through: 9.3
Branch
------
REL9_5_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/eff71cd910ad8cd1931bd78103f8d5b9fd8e634b
Modified Files
--------------
doc/src/sgml/func.sgml | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
^ permalink raw reply [nested|flat] 9+ messages in thread
* pgsql: doc: use simpler language for NULL return from ANY/ALL
@ 2018-11-02 12:54 Bruce Momjian <bruce@momjian.us>
0 siblings, 0 replies; 9+ messages in thread
From: Bruce Momjian @ 2018-11-02 12:54 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: use simpler language for NULL return from ANY/ALL
Previously the combination of "does not return" and "any row" caused
ambiguity.
Reported-by: KES <kes-kes@yandex.ru>
Discussion: https://postgr.es/m/153701242703.22334.1476830122267077397@wrigleys.postgresql.org
Reviewed-by: David G. Johnston
Backpatch-through: 9.3
Branch
------
REL9_3_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/f499dabbd51da787aae359f62d336d439dd440ed
Modified Files
--------------
doc/src/sgml/func.sgml | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
^ permalink raw reply [nested|flat] 9+ messages in thread
* pgsql: doc: use simpler language for NULL return from ANY/ALL
@ 2018-11-02 12:54 Bruce Momjian <bruce@momjian.us>
0 siblings, 0 replies; 9+ messages in thread
From: Bruce Momjian @ 2018-11-02 12:54 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: use simpler language for NULL return from ANY/ALL
Previously the combination of "does not return" and "any row" caused
ambiguity.
Reported-by: KES <kes-kes@yandex.ru>
Discussion: https://postgr.es/m/153701242703.22334.1476830122267077397@wrigleys.postgresql.org
Reviewed-by: David G. Johnston
Backpatch-through: 9.3
Branch
------
REL_11_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/61abff11f29e98abf8badfeca86cf05650911998
Modified Files
--------------
doc/src/sgml/func.sgml | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
^ permalink raw reply [nested|flat] 9+ messages in thread
* pgsql: doc: use simpler language for NULL return from ANY/ALL
@ 2018-11-02 12:54 Bruce Momjian <bruce@momjian.us>
0 siblings, 0 replies; 9+ messages in thread
From: Bruce Momjian @ 2018-11-02 12:54 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
doc: use simpler language for NULL return from ANY/ALL
Previously the combination of "does not return" and "any row" caused
ambiguity.
Reported-by: KES <kes-kes@yandex.ru>
Discussion: https://postgr.es/m/153701242703.22334.1476830122267077397@wrigleys.postgresql.org
Reviewed-by: David G. Johnston
Backpatch-through: 9.3
Branch
------
REL9_6_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/f5382cfc7036325867b4d99f156ef7800aa15501
Modified Files
--------------
doc/src/sgml/func.sgml | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: pgsql: doc: use simpler language for NULL return from ANY/ALL
@ 2018-11-02 14:20 Tom Lane <tgl@sss.pgh.pa.us>
parent: Bruce Momjian <bruce@momjian.us>
0 siblings, 1 reply; 9+ messages in thread
From: Tom Lane @ 2018-11-02 14:20 UTC (permalink / raw)
To: Bruce Momjian <bruce@momjian.us>; +Cc: pgsql-committers@lists.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
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: pgsql: doc: use simpler language for NULL return from ANY/ALL
@ 2018-11-02 17:05 Bruce Momjian <bruce@momjian.us>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 9+ messages in thread
From: Bruce Momjian @ 2018-11-02 17:05 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-committers@lists.postgresql.org
On Fri, Nov 2, 2018 at 10:20:21AM -0400, Tom Lane wrote:
> 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."
Agreed, done.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +
^ permalink raw reply [nested|flat] 9+ messages in thread
end of thread, other threads:[~2018-11-02 17:05 UTC | newest]
Thread overview: 9+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-11-02 12:54 pgsql: doc: use simpler language for NULL return from ANY/ALL Bruce Momjian <bruce@momjian.us>
2018-11-02 14:20 ` Re: pgsql: doc: use simpler language for NULL return from ANY/ALL Tom Lane <tgl@sss.pgh.pa.us>
2018-11-02 17:05 ` Re: pgsql: doc: use simpler language for NULL return from ANY/ALL Bruce Momjian <bruce@momjian.us>
2018-11-02 12:54 pgsql: doc: use simpler language for NULL return from ANY/ALL Bruce Momjian <bruce@momjian.us>
2018-11-02 12:54 pgsql: doc: use simpler language for NULL return from ANY/ALL Bruce Momjian <bruce@momjian.us>
2018-11-02 12:54 pgsql: doc: use simpler language for NULL return from ANY/ALL Bruce Momjian <bruce@momjian.us>
2018-11-02 12:54 pgsql: doc: use simpler language for NULL return from ANY/ALL Bruce Momjian <bruce@momjian.us>
2018-11-02 12:54 pgsql: doc: use simpler language for NULL return from ANY/ALL Bruce Momjian <bruce@momjian.us>
2018-11-02 12:54 pgsql: doc: use simpler language for NULL return from ANY/ALL Bruce Momjian <bruce@momjian.us>
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