betz            Mon Apr 29 08:07:49 2002 EDT

  Modified files:              
    /phpdoc/en/reference/dbm    reference.xml 
  Log:
  new structure, some text ito sections added.
  
Index: phpdoc/en/reference/dbm/reference.xml
diff -u phpdoc/en/reference/dbm/reference.xml:1.2 
phpdoc/en/reference/dbm/reference.xml:1.3
--- phpdoc/en/reference/dbm/reference.xml:1.2   Mon Apr 15 14:56:32 2002
+++ phpdoc/en/reference/dbm/reference.xml       Mon Apr 29 08:07:49 2002
@@ -1,17 +1,68 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
  <reference id="ref.dbm">
   <title>DBM Functions</title>
   <titleabbrev>DBM</titleabbrev>
 
   <partintro>
-   <simpara>
-    These functions allow you to store records stored in a dbm-style
-    database. This type of database (supported by the Berkeley DB,
-    GDBM, and some system libraries, as well as a built-in flatfile
-    library) stores key/value pairs (as opposed to the full-blown
-    records supported by relational databases).
-   </simpara>
+   <section id="dbm.intro">
+    &reftitle.intro;
+    <para>
+     These functions allow you to store records stored in a dbm-style
+     database. This type of database (supported by the Berkeley DB,
+     <ulink url="&url.gdbm;">GDBM</ulink>, and some system libraries,
+     as well as a built-in flatfile library) stores key/value pairs
+     (as opposed to the full-blown records supported by relational
+     databases).
+    </para>
+    <note>
+     <para>
+      However, dbm support is deprecated and you are encourged to use the
+      <link linkend="ref.dba">Database (dbm-style) abstraction layer functions</link>
+      instead.
+     </para>
+    </note>
+   </section>
+   
+   <section id="dbm.required">
+    &reftitle.required;
+    <para>
+     To use this functions you have to compile PHP with support for an
+     underlying database. See the 
+     <link linkend="dba.requirements">list</link> of supported Databases.
+    </para>
+   </section>
+   
+   <section id="dbm.installation">
+    &reftitle.install;
+    <para>
+     In order to use these functions, you must compile PHP with dbm support
+     by using the <option role="configure">--with-db</option> option. In
+     addtion you must ensure <link linkend="dba.installation">support</link>
+     for an underlying database or you can use some sytem libraries.
+    </para>
+   </section>
+   
+   <section id="dbm.runtime">
+    &reftitle.runtime;
+    &no.config;
+   </section>
+
+   <section id="dbm.resources">
+    &reftitle.resources;
+    <para>
+     The function <function>dbmopen</function> returns an database identifier
+     which is used by the other dbm-functions.
+    </para>
+   </section>
+   
+   <section id="dbm.constants">
+    &reftitle.constants;
+    &no.constants;
+   </section>
+   
+   <section id="dbm.examples">
+   &reftitle.examples;
    <para>
     <example>
      <title>DBM example</title>
@@ -30,11 +81,35 @@
      </programlisting>
     </example>
    </para>
+  </section>
   </partintro>
 
 &reference.dbm.functions;
 
  </reference>
+<!-- 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
+-->
+
+
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml


Reply via email to