SQL/JSON: Fix a paragraph in JSON_TABLE documentation

Using <replaceable>text</replaceable> inside parantheses is not a
common or good style, so rephrase a sentence to avoid that style.
Also rephrase the text in that paragraph a bit while at it.

Reported-by: Marcos Pegoraro <marcos@f10.com.br>
Author: Jian He <jian.universality@gmail.com>
Reviewed-by: Daniel Gustafsson <daniel@yesql.se>
Reviewed-by: Peter Eisentraut <peter@eisentraut.org>
Discussion: https://postgr.es/m/CAB-JLwZqH3Yec6Kz-4-+pa0ZG9QJBsxjJZwYcMZYzEDR_fXnKw@mail.gmail.com
This commit is contained in:
Amit Langote 2024-07-16 14:10:58 +09:00
parent d2b74882ca
commit 884d791b21

View File

@ -19038,14 +19038,15 @@ where <replaceable class="parameter">json_table_column</replaceable> is:
</term> </term>
<listitem> <listitem>
<para> <para>
The input data to query (<replaceable>context_item</replaceable>), The <replaceable>context_item</replaceable> specifies the input document
the JSON path expression defining the query (<replaceable>path_expression</replaceable>) to query, the <replaceable>path_expression</replaceable> is an SQL/JSON
with an optional name (<replaceable>json_path_name</replaceable>), and an path expression defining the query, and <replaceable>json_path_name</replaceable>
optional <literal>PASSING</literal> clause, which can provide data values is an optional name for the <replaceable>path_expression</replaceable>.
to the <replaceable>path_expression</replaceable>. The result of the input The optional <literal>PASSING</literal> clause provides data values for
data evaluation using the aforementioned elements is called the the variables mentioned in the <replaceable>path_expression</replaceable>.
<firstterm>row pattern</firstterm>, which is used as the source for row The result of the input data evaluation using the aforementioned elements
values in the constructed view. is called the <firstterm>row pattern</firstterm>, which is used as the
source for row values in the constructed view.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>