<chapter id="querymodel">
- <!-- $Id: querymodel.xml,v 1.17 2006-06-28 22:50:50 adam Exp $ -->
+ <!-- $Id: querymodel.xml,v 1.19 2006-06-30 14:36:12 marc Exp $ -->
<title>Query Model</title>
<sect1 id="querymodel-overview">
<para>
Since the <literal>type-1 (RPN)</literal>
query structure has no direct, useful string
- representation, every origin application needs to provide some
+ representation, every client application needs to provide some
form of mapping from a local query notation or representation to it.
</para>
<literal>explain</literal> operation, which provides the means
for learning which
<emphasis>fields</emphasis> (also called
- <emphasis>indexes</emphasis> or <emphasis>access points</emphasis>
+ <emphasis>indexes</emphasis> or <emphasis>access points</emphasis>)
are provided, which default parameter the server uses, which
retrieve document formats are defined, and which specific parts
of the general query model are supported.
<para>
It provides
the means to investigate the content of specific indexes.
- Scanning an index returns a handful of terms actually fond in
+ Scanning an index returns a handful of terms actually found in
the indexes, and in addition the <literal>scan</literal>
operation returns the number of documents indexed by each term.
A search client can use this information to propose proper
The <ulink url="&url.yaz.pqf;">PQF grammar</ulink>
is documented in the YAZ manual, and shall not be
repeated here. This textual PQF representation
- is always during search mapped to the equivalent Zebra internal
+ is not transmistted to Zebra during search, but it is in the
+ client mapped to the equivalent Z39.50 binary
query parse tree.
</para>
<para>
Defining a named result set and re-using it in the next query,
- using <literal>yaz-client</literal>.
+ using <literal>yaz-client</literal>. Notice that the client, not
+ the server, assigns the string <literal>'1'</literal> to the
+ named result set.
<screen>
Z> f @attr 1=4 mozart
...
Z> f @and @set 1 @attr 1=4 amadeus
...
Number of hits: 14, setno 2
- ...
- Z> f @attr 1=1016 beethoven
- ...
- Number of hits: 26, setno 3
- ...
</screen>
</para>
The next plus character marks the end of the section.
Currently Zebra only supports one specifier, the error tolerance,
which consists one digit.
+ <!-- TODO Nice thing, but what does
+ that error tolerance digit *mean*? Maybe an example would be nice? -->
</para>
<para>