From 11bc0866a2134c62326939bbc0c0c1b69120d714 Mon Sep 17 00:00:00 2001
From: Marcus Boerger <helly@php.net>
Date: Wed, 6 Nov 2002 09:24:29 +0000
Subject: [PATCH] Add information about flatfile and minor corrections

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@102746 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/dba/reference.xml | 38 +++++++++++++++++++++++++++++++++++--
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/reference/dba/reference.xml b/reference/dba/reference.xml
index f0397f5673..33956dfb9e 100644
--- a/reference/dba/reference.xml
+++ b/reference/dba/reference.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
  <reference id="ref.dba">
   <title>Database (dbm-style) abstraction layer functions</title>
   <titleabbrev>dba</titleabbrev>
@@ -96,6 +96,24 @@
         </entry>
        </row>
 
+       <row>
+        <entry><literal>cdb_make</literal></entry>
+        <entry>
+         Since PHP4.3 we support creation (not updating) of cdb files 
+         when the bundeled cdb library is used.
+        </entry>
+       </row>
+
+       <row>
+        <entry><literal>flatfile</literal></entry>
+        <entry>
+         This is available since PHP 4.3 for compatibility with the deprecated
+         <link linkend="ref.db">db</link> extension only and should be avoided. 
+         However you may use this where files were created in this format. That
+         happens when configure could not find any external library.
+        </entry>
+       </row>
+
       </tbody>
      </tgroup>
     </table>
@@ -175,7 +193,7 @@
          <option role="configure">--with-cdb[=DIR]</option>.
          <note>
           <para>
-           Since PHP 4.3 you can omit DIR to use the internal cdb library 
+           Since PHP 4.3 you can omit DIR to use the bundeled 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.
           </para>
@@ -183,6 +201,22 @@
         </entry>
        </row>
 
+       <row>
+         <entry><literal>flatfile</literal></entry>
+        <entry>
+         To enable support for flatfile add
+         <option role="configure">--with-flatfile</option>.
+         <note>
+          <para>
+           This was added in PHP 4.3 to add compatibility with deprecated
+           <link linkend="ref.db">db</link> extension. Uee this handler only
+           when you cannot install one of the libraries required by the other
+           handlers and when you cannot use bundeled cdb handler.
+          </para>
+         </note>
+        </entry>
+       </row>
+
       </tbody>
      </tgroup>
     </table>