Re: </replaceable> in parentesis is not usual on DOCs

On Thu, May 16, 2024 at 12:14 PM jian he <jian(dot)universality(at)gmail(dot)com> wrote:
>
> On Wed, May 15, 2024 at 8:34 PM Daniel Gustafsson <daniel(at)yesql(dot)se> wrote:
> >
> > > On 15 May 2024, at 14:04, Marcos Pegoraro <marcos(at)f10(dot)com(dot)br> wrote:
> >
> > > Why (context_item), (path_expression) and (json_path_name) are inside a parentheses ? This is not usual when explaining any other feature.
> >
> > Agreed, that's inconsisent with how for example json_table_column is documented
> > in the next list item under COLUMNS. Unless objected to I will remove these
> > parenthesis.
> >
>
> >> The input data to query (context_item), the JSON path expression defining the query (path_expression) with an optional name (json_path_name)
>
> i think the parentheses is for explaining that
> context_item refers "The input data to query";
> path_expression refers "the JSON path expression defining the query";
> json_path_name refers to "an optional name";
>
>

> removing parentheses means we need to rephrase this sentence?
> So I come up with the following rephrase:
>
> The context_item specifies the input data to query, the
> path_expression is a JSON path expression defining the query,
> json_path_name is an optional name for the path_expression. The
> optional PASSING clause can provide data values to the
> path_expression.

Based on this, write a simple patch.