Doc: fix ancient mistake, or at least obsolete info, in rules example.
authorTom Lane <tgl@sss.pgh.pa.us>
Mon, 11 Nov 2019 19:39:54 +0000 (14:39 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Mon, 11 Nov 2019 19:39:54 +0000 (14:39 -0500)
commitb75667d84fb3f96418dcef4e464ad0dab97237b6
tree4f4d2c814be9615768dd31974b440bc4995e1b29
parent96bcc335a3c1ce92e98dfcfddaa21d21f8b8026e
Doc: fix ancient mistake, or at least obsolete info, in rules example.

The example of expansion of multiple views claimed that the resulting
subquery nest would not get fully flattened because of an aggregate
function.  There's no aggregate in the example, though, only a user
defined function confusingly named MIN().  In a modern server, the
reason for the non-flattening is that MIN() is volatile, but I'm
unsure whether that was true back when this text was written.

Let's reduce the confusion level by using LEAST() instead (which
we didn't have at the time this example was created).  And then
we can just say that the planner will flatten the sub-queries, so
the rewrite system doesn't have to.

Noted by Paul Jungwirth.  This text is old enough to vote, so
back-patch to all supported branches.

Discussion: https://postgr.es/m/CA+renyXZFnmp9PcvX1EVR2dR=XG5e6E-AELr8AHCNZ8RYrpnPw@mail.gmail.com
doc/src/sgml/rules.sgml