Re: Missing jsonb_ ... functions on DOCs

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

In response to

Responses

Browse pgsql-hackers by date

  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