dickmeiss               Tue Mar 13 09:08:09 2001 EDT

  Modified files:              
    /phpdoc/en/functions        yaz.xml 
  Log:
  Documentation for yaz_database.
  
  
Index: phpdoc/en/functions/yaz.xml
diff -u phpdoc/en/functions/yaz.xml:1.10 phpdoc/en/functions/yaz.xml:1.11
--- phpdoc/en/functions/yaz.xml:1.10    Thu Mar  8 02:47:17 2001
+++ phpdoc/en/functions/yaz.xml Tue Mar 13 09:08:09 2001
@@ -164,8 +164,7 @@
    <refnamediv>
     <refname>yaz_connect</refname>
     <refpurpose>
-     Prepares for a connection and Z-association with a target.
-     Returns a positive association ID on success; zero on failure
+     Prepares for a connection and Z-association to a Z39.50 target.
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -182,6 +181,10 @@
       </funcprototype>
     </funcsynopsis>
     <para>
+     This function returns a positive ID on success; zero on
+     failure.
+    </para>
+    <para>
      <function>Yaz_connect</function> prepares for a connection to a
      Z39.50 target. The zurl argument takes the form
      host[:port][/database]. If port is omitted 210 is used. If
@@ -210,8 +213,8 @@
      Returns error for target (last request). A positive value is
      returned if the target returned a diagnostic code; a value of
      zero is returned if no errors occurred (success); negative value
-     is returned for other errors targets didn't indicate the error in
-     question.
+     is returned for other errors (such as when the target
+     closed connection, etc).
     </para>
     <para>
      <function>yaz_errno</function> should be called after network
@@ -231,7 +234,7 @@
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
-      <funcdef>int <function>yaz_error</function></funcdef>
+      <funcdef>string <function>yaz_error</function></funcdef>
       <paramdef>int <parameter>id</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -289,6 +292,38 @@
      to specify the element set name for records to be retrieved.
      Most servers support <literal>F</literal> (full) and
      <literal>B</literal> (brief).
+    </para>
+    <para>
+     Returns true on success; false on error. 
+    </para>
+   </refsect1>
+  </refentry>
+
+  <refentry id="function.yaz-database">
+   <refnamediv>
+    <refname>yaz_database</refname>
+    <refpurpose>
+     Specifies the databases within a session
+    </refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>int <function>yaz_database</function></funcdef>
+      <paramdef>int <parameter>id</parameter></paramdef>
+      <paramdef>string <parameter>databases</parameter></paramdef>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     This function specifies one or more databases to be used in search,
+     retrieval, etc. - overriding databases specified in call to
+     <function>yaz_connect</function>. Multiple databases are
+     separated by a plus sign <literal>+</literal>.
+    </para>
+    <para>
+     This function allows you to use different sets of databases within
+     a session.
     </para>
     <para>
      Returns true on success; false on error. 


Reply via email to