MIME-Version: 1.0
From: Yousef Mohamed <yousssef.mohammmed.12@gmail.com>
Date: Mon, 6 Apr 2026 00:38:17 +0200
Message-ID: 
 <CABA=AZ3GGrg+T7GrYq-iuKyJrAOwC6qZ5DStHzVLFOGrToPqew@mail.gmail.com>
Subject: issue in the doc
To: pgsql-docs@lists.postgresql.org
Content-Type: multipart/alternative; boundary="0000000000007def8b064ebe3507"
Archived-At: 
 <https://www.postgresql.org/message-id/CABA%3DAZ3GGrg%2BT7GrYq-iuKyJrAOwC6qZ5DStHzVLFOGrToPqew%40mail.gmail.com>
Precedence: bulk

--0000000000007def8b064ebe3507
Content-Type: text/plain; charset="UTF-8"

Page:
https://www.postgresql.org/docs/current/textsearch-intro.html

The documentation says:

tsvector @@ tsquery
tsquery  @@ tsvector
text @@ tsquery
text @@ text

The first two of these we saw already. The form text @@ tsquery is
equivalent to to_tsvector(x) @@ y. The form text @@ text is equivalent
to to_tsvector(x)
@@ plainto_tsquery(y).


Question:

In the expression:
to_tsvector(x) @@ plainto_tsquery(y)

what do x and y refer to exactly?

are they correspond to the left-hand and right-hand sides of the original
expression (text @@ text) ?

if yes , i think it's better to mention the order of the x and y like :
(x @@ y ) or ( y @@ x)

thanks

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

<div dir=3D"rtl"><p style=3D"box-sizing:border-box;margin-top:0px;margin-bo=
ttom:1rem;color:rgb(0,0,0);font-family:&quot;Open Sans&quot;,sans-serif;fon=
t-size:14.4px;text-align:left" dir=3D"ltr">Page:<br><a href=3D"https://www.=
postgresql.org/docs/current/textsearch-intro.html">https://www.postgresql.o=
rg/docs/current/textsearch-intro.html</a><br><br>The documentation says:</p=
><pre class=3D"gmail-programlisting" style=3D"box-sizing:border-box;font-fa=
mily:monospace,monospace;font-size:14.4px;margin:1rem 0px;overflow:auto;col=
or:rgb(0,0,0);background-color:rgb(248,249,250);border-radius:0.25rem;paddi=
ng:0.8rem;border-color:rgb(206,212,218);border-style:solid;border-width:1px=
;text-align:left">tsvector @@ tsquery
tsquery  @@ tsvector
text @@ tsquery
text @@ text
</pre><p style=3D"box-sizing:border-box;margin-top:0px;margin-bottom:1rem;c=
olor:rgb(0,0,0);font-family:&quot;Open Sans&quot;,sans-serif;font-size:14.4=
px;text-align:left">The first two of these we saw already. The form=C2=A0<c=
ode class=3D"gmail-type" style=3D"box-sizing:border-box;font-family:monospa=
ce,monospace;font-size:1em;background-color:rgb(248,249,250);border-radius:=
0.25rem;margin:0.6rem 0px">text</code>=C2=A0<code class=3D"gmail-literal" s=
tyle=3D"box-sizing:border-box;font-family:monospace,monospace;font-size:1em=
;background-color:rgb(248,249,250);border-radius:0.25rem;margin:0.6rem 0px"=
>@@</code>=C2=A0<code class=3D"gmail-type" style=3D"box-sizing:border-box;f=
ont-family:monospace,monospace;font-size:1em;background-color:rgb(248,249,2=
50);border-radius:0.25rem;margin:0.6rem 0px">tsquery</code>=C2=A0is equival=
ent to=C2=A0<code class=3D"gmail-literal" style=3D"box-sizing:border-box;fo=
nt-family:monospace,monospace;font-size:1em;background-color:rgb(248,249,25=
0);border-radius:0.25rem;margin:0.6rem 0px">to_tsvector(x) @@ y</code>. The=
 form=C2=A0<code class=3D"gmail-type" style=3D"box-sizing:border-box;font-f=
amily:monospace,monospace;font-size:1em;background-color:rgb(248,249,250);b=
order-radius:0.25rem;margin:0.6rem 0px">text</code>=C2=A0<code class=3D"gma=
il-literal" style=3D"box-sizing:border-box;font-family:monospace,monospace;=
font-size:1em;background-color:rgb(248,249,250);border-radius:0.25rem;margi=
n:0.6rem 0px">@@</code>=C2=A0<code class=3D"gmail-type" style=3D"box-sizing=
:border-box;font-family:monospace,monospace;font-size:1em;background-color:=
rgb(248,249,250);border-radius:0.25rem;margin:0.6rem 0px">text</code>=C2=A0=
is equivalent to=C2=A0<code class=3D"gmail-literal" style=3D"box-sizing:bor=
der-box;font-family:monospace,monospace;font-size:1em;background-color:rgb(=
248,249,250);border-radius:0.25rem;margin:0.6rem 0px">to_tsvector(x) @@ pla=
into_tsquery(y)</code>.</p><p style=3D"box-sizing:border-box;margin-top:0px=
;margin-bottom:1rem;color:rgb(0,0,0);font-family:&quot;Open Sans&quot;,sans=
-serif;font-size:14.4px;text-align:left" dir=3D"ltr"><br>Question:<br><br>I=
n the expression:<br>to_tsvector(x) @@ plainto_tsquery(y)<br><br>what do x =
and y refer to exactly?<br><br>are they correspond to the left-hand and rig=
ht-hand sides of the original expression (text @@ text) ?=C2=A0</p><p style=
=3D"box-sizing:border-box;margin-top:0px;margin-bottom:1rem;color:rgb(0,0,0=
);font-family:&quot;Open Sans&quot;,sans-serif;font-size:14.4px;text-align:=
left" dir=3D"ltr">if yes , i think it&#39;s better to mention the order of =
the x and y like : (x=C2=A0@@ y ) or ( y @@ x)=C2=A0</p><p style=3D"box-siz=
ing:border-box;margin-top:0px;margin-bottom:1rem;color:rgb(0,0,0);font-fami=
ly:&quot;Open Sans&quot;,sans-serif;font-size:14.4px;text-align:left" dir=
=3D"ltr">thanks=C2=A0</p></div>

--0000000000007def8b064ebe3507--