rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

In text search docs, properly use indexterm _zone_ only when we want an 

entire section, per Peter.
This commit is contained in:
Bruce Momjian 2007-08-31 04:52:29 +00:00
parent 6e832b059e
commit 99a01bfd1e
3 changed files with 87 additions and 91 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
doc/src/sgml/datatype.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.208 2007/08/29 20:37:14 momjian Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.209 2007/08/31 04:52:29 momjian Exp $ -->
<chapter id="datatype">
<title id="datatype-title">Data Types</title>
@ -3281,20 +3281,18 @@ a0eebc999c0b4ef8bb6d6bb9bd380a11
<variablelist>
<indexterm zone="datatype-textsearch">
<primary>tsvector</primary>
</indexterm>
<varlistentry>
<term><firstterm>tsvector</firstterm></term>
<listitem>
<para>
<type>tsvector</type> is a data type that represents a document and is
optimized for full text searching. In the simplest case,
<type>tsvector</type> is a sorted list of lexemes, so even without indexes
full text searches perform better than standard <literal>~</literal> and
<literal>LIKE</literal> operations:
<type>tsvector</type>
<indexterm><primary>tsvector</primary></indexterm> is a data type
that represents a document and is optimized for full text searching.
In the simplest case, <type>tsvector</type> is a sorted list of
lexemes, so even without indexes full text searches perform better
than standard <literal>~</literal> and <literal>LIKE</literal>
operations:
<programlisting>
SELECT 'a fat cat sat on a mat and ate a fat rat'::tsvector;
@ -3355,19 +3353,17 @@ SELECT 'fat:1 rat:2'::tsvector || 'fat:1 cat:2'::tsvector;
</varlistentry>
<indexterm zone="datatype-textsearch">
<primary>tsquery</primary>
</indexterm>
<varlistentry>
<term><firstterm>tsquery</firstterm></term>
<listitem>
<para>
<type>tsquery</type> is a data type for textual queries which supports
the boolean operators <literal>&amp;</literal> (AND), <literal>|</literal> (OR),
and parentheses. A <type>tsquery</type> consists of lexemes
(optionally labeled by letters) with boolean operators in between:
<type>tsquery</type>
<indexterm><primary>tsquery</primary></indexterm> is a data type
for textual queries which supports the boolean operators
<literal>&amp;</literal> (AND), <literal>|</literal> (OR), and
parentheses. A <type>tsquery</type> consists of lexemes (optionally
labeled by letters) with boolean operators in between:
<programlisting>
SELECT 'fat &amp; cat'::tsquery;

50
doc/src/sgml/func.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.390 2007/08/29 21:51:45 momjian Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.391 2007/08/31 04:52:29 momjian Exp $ -->
<chapter id="functions">
<title>Functions and Operators</title>
@ -7585,7 +7585,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple
<varlistentry>
<indexterm zone="functions-textsearch-search-operator">
<indexterm>
<primary>TSVECTOR @@ TSQUERY</primary>
</indexterm>
@ -7620,7 +7620,7 @@ SELECT 'a fat cat sat on a mat and ate a fat rat'::tsvector @@ 'fat &amp; cow'::
<varlistentry>
<indexterm zone="functions-textsearch-search-operator">
<indexterm>
<primary>TEXT @@ TSQUERY</primary>
</indexterm>
@ -7652,7 +7652,7 @@ SELECT 'a fat cat sat on a mat and ate a fat rat'::text @@ 'cat &amp; cow'::tsqu
<varlistentry>
<indexterm zone="functions-textsearch-search-operator">
<indexterm>
<primary>TEXT @@ TEXT</primary>
</indexterm>
@ -7701,7 +7701,7 @@ SELECT 'a fat cat sat on a mat and ate a fat rat' @@ 'cat cow';
<varlistentry>
<indexterm zone="functions-textsearch-tsvector">
<indexterm>
<primary>to_tsvector</primary>
</indexterm>
@ -7723,7 +7723,7 @@ SELECT 'a fat cat sat on a mat and ate a fat rat' @@ 'cat cow';
<varlistentry>
<indexterm zone="functions-textsearch-tsvector">
<indexterm>
<primary>strip</primary>
</indexterm>
@ -7746,7 +7746,7 @@ SELECT 'a fat cat sat on a mat and ate a fat rat' @@ 'cat cow';
<varlistentry>
<indexterm zone="functions-textsearch-tsvector">
<indexterm>
<primary>setweight</primary>
</indexterm>
@ -7771,7 +7771,7 @@ SELECT 'a fat cat sat on a mat and ate a fat rat' @@ 'cat cow';
<varlistentry>
<indexterm zone="functions-textsearch-tsvector">
<indexterm>
<primary>tsvector concatenation</primary>
</indexterm>
@ -7802,7 +7802,7 @@ SELECT 'a fat cat sat on a mat and ate a fat rat' @@ 'cat cow';
<varlistentry>
<indexterm zone="functions-textsearch-tsvector">
<indexterm>
<primary>length(tsvector)</primary>
</indexterm>
@ -7821,7 +7821,7 @@ SELECT 'a fat cat sat on a mat and ate a fat rat' @@ 'cat cow';
<varlistentry>
<indexterm zone="functions-textsearch-tsvector">
<indexterm>
<primary>text::tsvector</primary>
</indexterm>
@ -7846,7 +7846,7 @@ SELECT 'a fat cat sat on a mat and ate a fat rat' @@ 'cat cow';
<varlistentry>
<indexterm zone="functions-textsearch-tsvector">
<indexterm>
<primary>trigger</primary>
<secondary>for updating a derived tsvector column</secondary>
</indexterm>
@ -7896,7 +7896,7 @@ tsvector_update_trigger(tsv, 'pg_catalog.english', strMessage);
<varlistentry>
<indexterm zone="functions-textsearch-tsvector">
<indexterm>
<primary>ts_stat</primary>
</indexterm>
@ -7943,7 +7943,7 @@ LIMIT 10;
<varlistentry>
<indexterm zone="functions-textsearch-tsvector">
<indexterm>
<primary>Btree operations for tsvector</primary>
</indexterm>
@ -7979,7 +7979,7 @@ LIMIT 10;
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>to_tsquery</primary>
</indexterm>
@ -8026,7 +8026,7 @@ SELECT to_tsquery('''supernovae stars'' &amp; !crab');
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>plainto_tsquery</primary>
</indexterm>
@ -8051,7 +8051,7 @@ SELECT to_tsquery('''supernovae stars'' &amp; !crab');
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>querytree</primary>
</indexterm>
@ -8081,7 +8081,7 @@ SELECT querytree(to_tsquery('!defined'));
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>text::tsquery casting</primary>
</indexterm>
@ -8107,7 +8107,7 @@ SELECT querytree(to_tsquery('!defined'));
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>numnode</primary>
</indexterm>
@ -8146,7 +8146,7 @@ SELECT numnode(plainto_tsquery('long table'));
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>TSQUERY &amp;&amp; TSQUERY</primary>
</indexterm>
@ -8165,7 +8165,7 @@ SELECT numnode(plainto_tsquery('long table'));
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>TSQUERY || TSQUERY</primary>
</indexterm>
@ -8184,7 +8184,7 @@ SELECT numnode(plainto_tsquery('long table'));
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>!! TSQUERY</primary>
</indexterm>
@ -8203,7 +8203,7 @@ SELECT numnode(plainto_tsquery('long table'));
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>Btree operations for tsquery</primary>
</indexterm>
@ -8257,7 +8257,7 @@ INSERT INTO aliases VALUES('a', 'c');
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>ts_rewrite</primary>
</indexterm>
@ -8404,7 +8404,7 @@ WHERE 'a &amp; b' @> t;
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>TSQUERY @&gt; TSQUERY</primary>
</indexterm>
@ -8423,7 +8423,7 @@ WHERE 'a &amp; b' @> t;
<varlistentry>
<indexterm zone="functions-textsearch-tsquery">
<indexterm>
<primary>tsquery &lt;@ tsquery</primary>
</indexterm>

10
doc/src/sgml/textsearch.sgml
View File

@ -429,6 +429,11 @@ ORDER BY rank DESC LIMIT 10;
<sect2 id="textsearch-parser">
<title>Parsing</title>
<indexterm zone="textsearch-parser">
<primary>text search</primary>
<secondary>parse</secondary>
</indexterm>
<para>
Full text searching in <productname>PostgreSQL</productname> provides
function <function>to_tsvector</function>, which converts a document to
@ -544,11 +549,6 @@ UPDATE tt SET ti=
<varlistentry>
<indexterm zone="textsearch-parser">
<primary>text search</primary>
<secondary>parse</secondary>
</indexterm>
<term>
<synopsis>
ts_parse(<replaceable class="PARAMETER">parser</replaceable>, <replaceable class="PARAMETER">document</replaceable> TEXT) returns SETOF <type>tokenout</type>