Re: cvs: phpdoc /en/reference/dba/functions dba-open.xml

It return false on failure as documented. I feel we should use this for all functions where any failure results in false. This way users easily know that they must check for func()!==false marcus At 11:20 06.11.2002, Philip Olson wrote:

Closing Bug #19077 #maybe someone will analyse which libraries fail and wich work (e.g. wait).

-      <type>resource</type><methodname>dba_open</methodname>
+      <type>resource|false</type><methodname>dba_open</methodname>

Can you please explain the addition of false here? Does this return false on failure? Or will it at some point return false yet not fail? That would be odd. Anyway, please explain. If it just returns false on failure, false does not get listed here but rather it's described later on in the description. If a function happens to return different types while not failing, it's labeled as mixed. Regards, Philip <methodparam><type>string</type><parameter>path</parameter></methodparam> <methodparam><type>string</type><parameter>mode</parameter></methodparam> <methodparam><type>string</type><parameter>handler</parameter></methodparam> @@ -40,6 +40,16 @@

      <function>dba_open</function> returns a positive handle or &false;, in
      the case the open is successful or fails, respectively.
     </para>
+    <note>
+     <para>
+      There can only be one writer for one database file. When you use dba on
+      a webserver and more than one request requires write operations they can
+      only be done one after another. Unfortuanetly some of the external
+      libraries simply fail or ignore this when trying to open the database for
+      another write operation. In this case you must use semaphores to guard
+      against. See <link linkend="ref.sysvsem">System V semaphore support</link>.
+     </para>
+    </note>
     <para>
      See also:
      <function>dba_popen</function>

-- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php