Clarify the result order of unnest(multirange).
authorJeff Davis <jdavis@postgresql.org>
Fri, 27 Oct 2023 22:21:42 +0000 (15:21 -0700)
committerJeff Davis <jdavis@postgresql.org>
Fri, 27 Oct 2023 23:06:12 +0000 (16:06 -0700)
commitd014e6cb188664d053cbed87130416617226b373
tree1cb9bdae2b8cf3f37658022890f7136b0acaa3fb
parent12cf3ac7f328ac439a8eca2bfb7771fb6a4f3aa3
Clarify the result order of unnest(multirange).

It is best not to mention the storage order, because that is
an implementation detail and has confused at least one user,
who assumed that the storage order is the order in which the
constituent ranges were written in SQL.

Since the sorting order is explained at the beginning of the
page, it should be sufficient to say that the ranges are
returned in ascending order.

Author: Laurenz Albe
Reviewed-by: Daniel Fredouille
Discussion: https://postgr.es/m/169627213477.3727338.17653654241633692682%40wrigleys.postgresql.org
doc/src/sgml/func.sgml