Date: Fri, 7 Mar 2025 03:12:17 +0100
From: Erik Wienhold <ewie@ewie.name>
To: Jai Sharma <jai@jai.moe>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Docs search does not work for the "@>" operator
Message-ID: <f50c3e36-9f10-4da1-ac77-7ffcb7d93f67@ewie.name>
References: <875af479-d548-456d-bc6c-e196e76a5407@app.fastmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <875af479-d548-456d-bc6c-e196e76a5407@app.fastmail.com>
Archived-At: 
 <https://www.postgresql.org/message-id/f50c3e36-9f10-4da1-ac77-7ffcb7d93f67%40ewie.name>
Precedence: bulk

On 2025-03-03 19:35 +0100, Jai Sharma wrote:
> When searching on the Postgres docs website, searching with the strings
> `@>` or `"@>"` returns no results.
> 
> Ordinarily, I would expect to see results returned including this page (which
> was the page I was looking for):
> https://www.postgresql.org/docs/17/functions-range.html

Any operator, in fact, because pgweb implements its search with
plainto_tsquery [1] which ignores punctuation.

> Can the search be updated to work with these characters please?

I don't see how because information about these operators (or any other
punctuation) is lost when pages are converted to tsvector by the web
crawler.  Maybe a separate operator index where you could search with
ctrl+f is an option.  But I don't know if that is feasible with the
current document structure without having to maintain basically two
separate operator docs.  But DocBook can certainly index symbols [2].

[1] https://git.postgresql.org/gitweb/?p=pgweb.git;a=blob;f=tools/search/sql/functions.sql;h=9ee5c4a51c0fba97e7e851a78db33669ecfc440e;hb=HEAD#l12
[2] https://www.postgresql.org/docs/current/bookindex.html#indexdiv-Symbols

-- 
Erik Wienhold