MIME-Version: 1.0
In-Reply-To: 
 <CABA=AZ3GGrg+T7GrYq-iuKyJrAOwC6qZ5DStHzVLFOGrToPqew@mail.gmail.com>
References: 
 <CABA=AZ3GGrg+T7GrYq-iuKyJrAOwC6qZ5DStHzVLFOGrToPqew@mail.gmail.com>
From: "David G. Johnston" <david.g.johnston@gmail.com>
Date: Sun, 5 Apr 2026 16:00:03 -0700
Message-ID: 
 <CAKFQuwZne4AfBc379r+FNq1gJ0SMmNKZzcvJ6pFZso5-OfbP4w@mail.gmail.com>
Subject: Re: issue in the doc
To: Yousef Mohamed <yousssef.mohammmed.12@gmail.com>
Cc: "pgsql-docs@lists.postgresql.org" <pgsql-docs@lists.postgresql.org>
Content-Type: multipart/alternative; boundary="000000000000dc51d0064ebe8292"
Archived-At: 
 <https://www.postgresql.org/message-id/CAKFQuwZne4AfBc379r%2BFNq1gJ0SMmNKZzcvJ6pFZso5-OfbP4w%40mail.gmail.com>
Precedence: bulk

--000000000000dc51d0064ebe8292
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Sunday, April 5, 2026, Yousef Mohamed <yousssef.mohammmed.12@gmail.com>
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=E2=80=99t an expression, it=E2=80=99s one=E2=80=99s 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=E2=80=99m not following how you think this could be improved.  I get it=
=E2=80=99s 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=E2=80=99t make sense.  I have a few thoughts of=
 my own,
chief among them being using real examples, but it doesn=E2=80=99t really m=
y
threshold to work on at this time.

David J.

--000000000000dc51d0064ebe8292
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Sunday, April 5, 2026, Yousef Mohamed &lt;<a href=3D"mailto:yousssef.moh=
ammmed.12@gmail.com">yousssef.mohammmed.12@gmail.com</a>&gt; wrote:<blockqu=
ote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc s=
olid;padding-left:1ex"><div dir=3D"rtl"><p style=3D"margin-top:0px;margin-b=
ottom:1rem;color:rgb(0,0,0);font-family:&quot;Open Sans&quot;,sans-serif;fo=
nt-size:14.4px;text-align:left" dir=3D"ltr">Question:<br><br>In the express=
ion:<br>to_tsvector(x) @@ plainto_tsquery(y)<br><br>what do x and y refer t=
o exactly?</p></div></blockquote><div>Local variables for the single expres=
sion being described. =C2=A0x 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. =
=C2=A0(Or unknown, which then defaults to text.).</div><div>=C2=A0</div><bl=
ockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #=
ccc solid;padding-left:1ex"><div dir=3D"rtl"><p style=3D"margin-top:0px;mar=
gin-bottom:1rem;color:rgb(0,0,0);font-family:&quot;Open Sans&quot;,sans-ser=
if;font-size:14.4px;text-align:left" dir=3D"ltr"><br>are they correspond to=
 the left-hand and right-hand sides of the original expression (text @@ tex=
t) ?=C2=A0</p></div></blockquote><div><div>In that x comes before y in the =
English alphabet just like in that left-to-right language left comes physic=
ally before right, yes.</div></div><div><br></div><div>(text @@ text) isn=
=E2=80=99t an expression, it=E2=80=99s one=E2=80=99s way of writing the nam=
e of a type.</div><div><br></div><blockquote class=3D"gmail_quote" style=3D=
"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir=3D=
"rtl"><p style=3D"margin-top:0px;margin-bottom:1rem;color:rgb(0,0,0);font-f=
amily:&quot;Open Sans&quot;,sans-serif;font-size:14.4px;text-align:left" di=
r=3D"ltr">if yes , i think it&#39;s better to mention the order of the x an=
d y like : (x=C2=A0@@ y ) or ( y @@ x)=C2=A0</p></div></blockquote><div>I=
=E2=80=99m not following how you think this could be improved.=C2=A0 I get =
it=E2=80=99s very western-centric, and admit it took me a moment to underst=
and, but once I did it seems quite clear to me.=C2=A0 A concrete change to =
consider would be helpful if this still doesn=E2=80=99t make sense.=C2=A0 I=
 have a few thoughts of my own, chief among them being using real examples,=
 but it doesn=E2=80=99t really my threshold to work on at this time.</div><=
div><br></div><div>David J.</div><div><br></div><div>=C2=A0</div>

--000000000000dc51d0064ebe8292--