| From: | Marcos Pegoraro <marcos(at)f10(dot)com(dot)br> |
|---|---|
| To: | Michael Paquier <michael(at)paquier(dot)xyz> |
| Cc: | pgsql-hackers <pgsql-hackers(at)postgresql(dot)org> |
| Subject: | Re: Missing jsonb_ ... functions on DOCs |
| Date: | 2026-05-11 15:07:33 |
| Message-ID: | CAB-JLwb+m=gspBheMGWq9TCPqgD70K30AQ3bNxPzg3KBsym2Bg@mail.gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
Em dom., 10 de mai. de 2026 às 23:08, Michael Paquier <michael(at)paquier(dot)xyz>
escreveu:
> Well, it seems to me that the intention is that it is pointless to
> document the functions because that the users need only to be aware of
> the operators, and the operators are enough to manipulate the jsonb
> blobs. Documenting the functions would be just duplicating what we
> already have for the operators, as listed here:
> https://www.postgresql.org/docs/devel/functions-json.html
A function is self explanatory, an operator is not.
If we do something like what was done in [1], we don't change much on the
page but at the same time we give the user both options.
regards
Marcos
[1] -
https://www.postgresql.org/docs/18/functions-string.html#FUNCTIONS-STRING-OTHER
| Attachment | Content-Type | Size |
|---|---|---|
| DOC jsonb functions with their related operators.diff | application/octet-stream | 3.5 KB |
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Antonin Houska | 2026-05-11 15:17:52 | Re: Adding REPACK [concurrently] |
| Previous Message | Aleksander Alekseev | 2026-05-11 15:04:21 | Re: Review - Patch for pg_bsd_indent: improve formatting of multiline comments |