Typos. Better introduction, really. Other, minor, updates.
[yaz-moved-to-github.git] / doc / zoom.xml
index ff34527..a069b1d 100644 (file)
@@ -1,5 +1,5 @@
-<!-- $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
@@ -8,7 +8,7 @@
    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>