Proposal to improve uniq function documentation in intarray extension
The Post Office <noreply@postgresql.org>
From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: martin.kalcher@aboutsource.net
Date: 2022-06-01T10:20:44Z
Lists: pgsql-docs
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/14/intarray.html
Description:
The **uniq** function in the **intarray** extension removes **adjacent**
duplicates from an integer array. The documentation[0] about this behavior
is correct, but the example is a bit misleading, because it sorts the array
before applying uniq. The sort can be overlooked **easily** and leads to the
impression that **uniq** removes all duplicates from the array.
I propse to change the example to somthing like that:
uniq('{1,2,2,3,1,1}'::integer[]) → {1,2,3,1}
It might be a good idea to refer to the **sort** function in case one wants
to remove all duplicates.
Cheers, Martin Kalcher
[0]
https://www.postgresql.org/docs/current/intarray.html#INTARRAY-FUNC-TABLE
Commits
-
Doc: improve example for intarray's uniq() function.
- 9985139046c3 13.8 landed
- c1ad8047a2c2 14.4 landed
- 4ecacc3c8cb4 15.0 landed