doc: clarify handling of ts_headline() operators & extra words

Reported-by: Ngigi Waithaka & Alex Malek

Bug: 15172

Discussion: https://postgr.es/m/152461454026.19805.6310947081647212894@wrigleys.postgresql.org

Backpatch-through: 16
This commit is contained in:
Bruce Momjian 2023-11-13 16:35:55 -05:00
parent f279241b09
commit 24943fba46
1 changed files with 4 additions and 1 deletions

View File

@ -1287,7 +1287,10 @@ ts_headline(<optional> <replaceable class="parameter">config</replaceable> <type
<para>
<function>ts_headline</function> accepts a document along
with a query, and returns an excerpt from
the document in which terms from the query are highlighted. The
the document in which terms from the query are highlighted.
Specifically, the function will use the query to select relevant
text fragments, and then highlight all words that appear in the query,
even if those word positions do not match the query's restrictions. The
configuration to be used to parse the document can be specified by
<replaceable>config</replaceable>; if <replaceable>config</replaceable>
is omitted, the