From: Tom Lane <tgl@sss.pgh.pa.us>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Doc: improve documentation for jsonpath behavior.
Date: Thu, 25 Jan 2024 16:32:32 +0000
Message-ID: <E1rT2eW-0033xb-V9@gemulon.postgresql.org> (raw)
Doc: improve documentation for jsonpath behavior.
Clarify the behavior of jsonpath operators and functions by
describing their two different modes of operation explicitly.
In addition to the SQL-spec behavior, where a path returns
a list of matching items, we have a "predicate check" form
that always returns a single boolean result. That was mentioned
in only one place, but it seems better to annotate each operator
and function as to which form(s) it takes. Also improve the
examples by converting them into actual executable SQL with
results, and do a bunch of incidental wordsmithing.
David Wheeler, reviewed by Erik Wienhold, Jian He, and myself
Discussion: https://postgr.es/m/7262A188-59CA-4A8A-AAD7-83D4FF0B9758@justatheory.com
Branch
------
master
Details
-------
https://git.postgresql.org/pg/commitdiff/7014c9a4bba2d1b67d60687afb5b2091c1d07f73
Modified Files
--------------
doc/src/sgml/func.sgml | 389 ++++++++++++++++++++++++++++++++++---------------
doc/src/sgml/json.sgml | 2 +-
2 files changed, 271 insertions(+), 120 deletions(-)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-committers@postgresql.org
Cc: tgl@sss.pgh.pa.us, pgsql-committers@lists.postgresql.org
Subject: Re: pgsql: Doc: improve documentation for jsonpath behavior.
In-Reply-To: <E1rT2eW-0033xb-V9@gemulon.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox