public inbox for [email protected]  

help / color / mirror / Atom feed

From: David G. Johnston <[email protected]>
To: Yousef Mohamed <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: issue in the doc
Date: Sun, 5 Apr 2026 16:00:03 -0700
Message-ID: <CAKFQuwZne4AfBc379r+FNq1gJ0SMmNKZzcvJ6pFZso5-OfbP4w@mail.gmail.com> (raw)
In-Reply-To: <CABA=AZ3GGrg+T7GrYq-iuKyJrAOwC6qZ5DStHzVLFOGrToPqew@mail.gmail.com>
References: <CABA=AZ3GGrg+T7GrYq-iuKyJrAOwC6qZ5DStHzVLFOGrToPqew@mail.gmail.com>

On Sunday, April 5, 2026, Yousef Mohamed <[email protected]>
wrote:
>
> Question:
>
> In the expression:
> to_tsvector(x) @@ plainto_tsquery(y)
>
> what do x and y refer to exactly?
>
Local variables for the single expression being described.  x is a text
typed value capable of being parsed as a vector, y is a text typed value
capable of being parsed as a query.  (Or unknown, which then defaults to
text.).


>
> are they correspond to the left-hand and right-hand sides of the original
> expression (text @@ text) ?
>
In that x comes before y in the English alphabet just like in that
left-to-right language left comes physically before right, yes.

(text @@ text) isn’t an expression, it’s one’s way of writing the name of a
type.

if yes , i think it's better to mention the order of the x and y like :
> (x @@ y ) or ( y @@ x)
>
I’m not following how you think this could be improved.  I get it’s very
western-centric, and admit it took me a moment to understand, but once I
did it seems quite clear to me.  A concrete change to consider would be
helpful if this still doesn’t make sense.  I have a few thoughts of my own,
chief among them being using real examples, but it doesn’t really my
threshold to work on at this time.

David J.

view thread (2+ messages)

reply

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: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: issue in the doc
  In-Reply-To: <CAKFQuwZne4AfBc379r+FNq1gJ0SMmNKZzcvJ6pFZso5-OfbP4w@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox