Re: [Minor] Possible missing syntax

On Thu, Oct 15, 2026 at 1:37 PM David G. Johnston <
david(dot)g(dot)johnston(at)gmail(dot)com> wrote:

> On Thu, Oct 15, 2026 at 9:12 AM Matemática A3K <matematica(dot)a3k(at)gmail(dot)com>
> wrote:
>
>> and something like "index_start to index_end" ("[2 to 3, 5 to 6]") seems
>> unlikely.
>>
>
> The row in question is technically correct.
>

> SELECT jsonb_path_query_array(
> '[10,20,30,40,50,60]'::jsonb,
> '$[1 to 2, 4 to 5]'
> ) AS result;
>
> [20, 30, 50, 60]
>

Indeed, thanks for the clarification!

> I'll agree the entire section could stand to use examples, like the ones
> preceding it.
>

> I'd probably also do:
>
> [{index | start_index to end_index}}, ...]
>
> Instead of leaving the inner syntax available only in the prose.
>

I think this is the best solution. When preparing the patch, I realized
that the markup
in the source of the docs is clear:
"
It can be given in two forms:
<literal><replaceable>index</replaceable></literal>
or <literal><replaceable>start_index</replaceable> to
<replaceable>end_index</replaceable></literal>.
"
My confusion arose because of how the <literal> is rendered in this context
in HTML.
I find it hard to distinguish the prose from it, I haven't found a way of
changing it and arguing for that change
seems hard because it's entirely subjective on your vision (however, if you
share this concern I can dig further
and ask for help in the docbook community).

Given this, I find this change to better align the row with the others, so
I am attaching a patch.