-<!-- $Id: zoom.xml,v 1.2 2001-10-24 09:27:59 adam Exp $ -->
- <chapter id="zoom"><title>ZOOM</title>
+<!-- $Id: zoom.xml,v 1.3 2001-10-24 20:12:36 adam Exp $ -->
+ <chapter id="zoom"><title>Building clients with ZOOM</title>
<para>
&zoom; is an acronym for Z39.50 Object Oriented Model and is
programming language or toolkit.
</para>
<para>
- The lack of a simple Z39.50 client API for &yaz; was more apparanet
+ The lack of a simple Z39.50 client API for &yaz; was more apparent
than ever. So, when the first ZOOM specification was available
an implementation for &yaz; was developed. For the first time, it is
now easier to develop clients than servers with &yaz;. This
<function>Z3950_connection_option</function>.
</para>
<para>
- The number of hits also called result-set is returned by
- function <function>3950_resultset_size</function>.
+ The number of hits also called result-count is returned by
+ function <function>Z3950_resultset_size</function>.
</para>
<para>
Function <function>Z3950_resultset_get</function> is similar to
and <literal>F</literal> for brief and full respectively.
</entry><entry>none</entry></row>
<row><entry>
- preferredRecordSyntax</entry><entry>Preferred Syntax, like
+ preferredRecordSyntax</entry><entry>Preferred Syntax, such as
<literal>USMARC</literal>, <literal>SUTRS</literal>, etc.
</entry><entry>none</entry></row>
<row><entry>
Records are created by functions
<function>Z3950_resultset_records</function> or
<function>Z3950_resultset_record</function>
- and destroyed by <function>Z3950_resultset_destroy</function>.
+ and destroyed by <function>Z3950_record_destroy</function>.
</para>
<para>
A single record is created and returned by function
<function>Z3950_resultset_record</function> that takes a
position as argument. First record has position zero.
- If no record could be obtained <literal>NULL</literal>.
+ If no record could be obtained <literal>NULL</literal> is returned.
</para>
<para>
- Function <function>Z39_resultset_records</function>retrieves
+ Function <function>Z39_resultset_records</function> retrieves
a number of records from a result set. Options <literal>start</literal>
and <literal>count</literal> specifies the range of records to
be returned. Upon completion <literal>recs[0], ..recs[*cnt]</literal>
occurred for connection <literal>cs[n-1]</literal>.
When no events are pending for the connections a value of zero is
returned.
- To make sure all outstanding requests are performed call is function
+ To make sure all outstanding requests are performed call this function
repeatedly until zero is returned.
</para>
</sect1>