Doc: improve documentation for UNNEST().
authorTom Lane <[email protected]>
Wed, 27 Jan 2021 17:50:17 +0000 (12:50 -0500)
committerTom Lane <[email protected]>
Wed, 27 Jan 2021 17:50:22 +0000 (12:50 -0500)
commit662affcfe9e816584e3d8602b3b4005236931bbb
tree42719d4809975f8fb0a669bd5f8ee25ec22db802
parent1f113abdf87cd085dee3927960bb4f70442b7250
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