git.postgresql.org Git - postgresql.git/commitdiff

git projects / postgresql.git / commitdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: 6286efb)
doc: use simpler language for NULL return from ANY/ALL
Fri, 2 Nov 2018 12:54:34 +0000 (08:54 -0400)
Fri, 2 Nov 2018 12:54:34 +0000 (08:54 -0400)
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


diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 10816f556bd970501efa576613f6f1068877c7f9..74e8cf185196ff008e964b01f09fe1248e982c10 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -15246,7 +15246,7 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2);
The result is <quote>false</quote> if the comparison returns false for every
subquery row (including the case where the subquery returns no
rows).
- The result is NULL if the comparison does not return true for any row,
+ The result is NULL if no comparison with a subquery row returns true,
and it returns NULL for at least one row.
</para>
@@ -15272,7 +15272,7 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2);
The result of <token>ALL</token> is <quote>true</quote> if all rows yield true
(including the case where the subquery returns no rows).
The result is <quote>false</quote> if any false result is found.
- The result is NULL if the comparison does not return false for any row,
+ The result is NULL if no comparison with a subquery row returns false,
and it returns NULL for at least one row.
</para>
@@ -15302,8 +15302,8 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2);
case where the subquery returns no rows).
The result is <quote>false</quote> if the comparison returns false for any
subquery row.
- The result is NULL if the comparison does not return false for any
- subquery row, and it returns NULL for at least one row.
+ The result is NULL if no comparison with a subquery row returns false,
+ and it returns NULL for at least one row.
</para>
<para>
This is the main PostgreSQL git repository.
RSS Atom

AltStyle によって変換されたページ (->オリジナル) /