Doc: improve documentation for UNNEST().
authorTom Lane <tgl@sss.pgh.pa.us>
Wed, 27 Jan 2021 17:50:17 +0000 (12:50 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Wed, 27 Jan 2021 17:50:17 +0000 (12:50 -0500)
commitbfda0a02444e204024d83db2874ec884960d24f0
tree7182dddc9ca656cc61ae19da32550a78d92b9d1c
parent2378d9232ea9a7d8147b17f7d78c14fbb4796c7d
Doc: improve documentation for UNNEST().

Per a user question, spell out that UNNEST() returns array elements
in storage order; also provide an example to clarify the behavior for
multi-dimensional arrays.

While here, also clarify the SELECT reference page's description of
WITH ORDINALITY.  These details were already given in 7.2.1.4, but
a reference page should not omit details.

Back-patch to v13; there's not room in the table in older versions.

Discussion: https://postgr.es/m/FF1FB31F-0507-4F18-9559-2DE6E07E3B43@gmail.com
doc/src/sgml/func.sgml
doc/src/sgml/ref/select.sgml