+ <para>
+ Records are created by functions
+ <function>Z3950_resultset_records</function> or
+ <function>Z3950_resultset_record</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> is returned.
+ </para>
+ <para>
+ Function <function>Z3950_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>
+ holds record objects for the records. These array of records
+ <literal>recs</literal> should be allocate prior to calling
+ <function>Z3950_resultset_records</function>. Note that for
+ records that couldn't be retrieved from the target
+ <literal>recs[ ..]</literal> is <literal>NULL</literal>.
+ </para>
+ <para id="zoom.record.get">
+ In order to extract information about a single record,
+ <function>Z3950_record_get</function> is provided. The
+ function returns a pointer to certain record information. The
+ nature (type) of the pointer depends on the <function>type</function>
+ given. In addition for certain types, the length
+ <literal>len</literal> passed will be set to the size in bytes of
+ the returned information. The types <literal>database</literal>,
+ <literal>syntax</literal> and <literal>render</literal> are
+ supported. More will be added later.
+ </para>