Doc: clarify use of RECURSIVE in WITH.

Apparently some people misinterpreted the syntax as being that
RECURSIVE is a prefix of individual WITH queries.  It's a modifier
for the WITH clause as a whole, so state that more clearly.

Discussion: https://postgr.es/m/ca53c6ce-a0c6-b14a-a8e3-162f0b2cc119@a-kretschmer.de

diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml
index 06d611b64c2c863dd9b4f7d7692b1876f1c13efd..691e4028030d9dd8f9fdf6b7cad15e6f63715101 100644 (file)
--- a/doc/src/sgml/ref/select.sgml
+++ b/doc/src/sgml/ref/select.sgml
@@ -273,6 +273,14 @@ TABLE [ ONLY ] table_name [ * ]
     that are earlier in the WITH list.
    
 
+   
+    When there are multiple queries in the WITH
+    clause, RECURSIVE should be written only once,
+    immediately after WITH.  It applies to all queries
+    in the WITH clause, though it has no effect on
+    queries that do not use recursion or forward references.
+   
+
    
     The primary query and the WITH queries are all
     (notionally) executed at the same time.  This implies that the effects of