Update to newly changes & additions

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@102665 c90b9560-bf6c-de11-be94-00142212c4b1

reference/dba/functions/dba-fetch.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
   <refentry id="function.dba-fetch">
    <refnamediv>
@@ -11,6 +11,7 @@
      <methodsynopsis>
       <type>string</type><methodname>dba_fetch</methodname>
       <methodparam><type>string</type><parameter>key</parameter></methodparam>
+      <methodparam choice="opt"><type>int</type><parameter>skip</parameter></methodparam>
       <methodparam><type>resource</type><parameter>handle</parameter></methodparam>
      </methodsynopsis>
     <para>
@@ -21,6 +22,11 @@
     <para>
      <parameter>Key</parameter> is the key the data is specified by.
     </para>
+    <para>
+     <parameter>Skip</parameter> is the number of key-value pairs to 
+     ignore when using cdb databases. This value is ignored for all other
+     databases which do not support multiple keys with the same name.
+    </para>
     <para>
      <parameter>Handle</parameter> is a database handle returned by
      <function>dba_open</function>.
@@ -35,6 +41,14 @@
      <function>dba_delete</function>, <function>dba_insert</function>,
      and <function>dba_replace</function>.
     </para>
+    <para>
+     <note>
+      <simpara>
+       The skip parameter is available since PHP 4.3 to support cdb's 
+       capability of multiple keys having the same name.
+      </simpara>
+     </note>
+    </para>
    </refsect1>
   </refentry>
 

reference/dba/functions/dba-handlers.xml

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.1 $ -->
+<!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
+  <refentry id="function.dba-handlers">
+   <refnamediv>
+    <refname>dba_handlers</refname>
+    <refpurpose>List handlers available</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+     <methodsynopsis>
+      <type>array</type><methodname>dba_handlers</methodname>
+     </methodsynopsis>
+    <para>
+     <function>dba_handlers</function> returns an array with all handlers
+     suppoerted by this extension.
+    </para>
+    <para>
+     When the internal cdb library is used you will see 'cdb' and 'cdb_make'.
+    </para>
+
+   </refsect1>
+  </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

reference/dba/functions/dba-list.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.1 $ -->
+<!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
+  <refentry id="function.dba-list">
+   <refnamediv>
+    <refname>dba_list</refname>
+    <refpurpose>List all open database files</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+     <methodsynopsis>
+      <type>array</type><methodname>dba_list</methodname>
+     </methodsynopsis>
+    <para>
+     <function>dba_list</function> returns an associative array with all 
+     open databse files in the form resourceid=>filename.
+    </para>
+
+   </refsect1>
+  </refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

reference/dba/reference.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
  <reference id="ref.dba">
   <title>Database (dbm-style) abstraction layer functions</title>
   <titleabbrev>dba</titleabbrev>
@@ -91,7 +91,8 @@
          Cdb is "a fast, reliable, lightweight package for creating and
          reading constant databases." It is from the author of qmail and
          can be found <ulink url="&url.cdb;">here</ulink>. Since it is
-         constant, we support only reading operations.
+         constant, we support only reading operations. And since PHP4.3
+         we support writing (not updating) through the internal cdb library.
         </entry>
        </row>
 
@@ -104,7 +105,7 @@
      <function>dba_popen</function> functions, one of the
      handler names must be supplied as an argument. The actually
      available list of handlers is displayed by invoking
-     <function>phpinfo</function>.
+     <function>phpinfo</function> or <function>dba_handlers</function>.
     </para>
    </section>
 
@@ -172,6 +173,11 @@
         <entry>
          To enable support for cdb add
          <option role="configure">--with-cdb[=DIR]</option>.
+         <note>
+          Since PHP 4.3 you can omit DIR to use the internal cdb library 
+          that adds the cdb_make handler which allows creation of cdb files
+          and allows to access cdb files on the network using php's streams.
+         </note>
         </entry>
        </row>