a little more structure ...

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

functions/dbplus.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.21 $ -->
+<!-- $Revision: 1.22 $ -->
  <reference id="ref.dbplus">
   <title>DB++ Functions</title>
   <titleabbrev>DB++</titleabbrev>
@@ -28,21 +28,25 @@
    <section id="dbplus.requirenments">
     <title>Requirements</title>
     <para>
-     You need the development libraries and header files included in
-     every db++ installation archive.  <ulink
-     url="&url.dbplus.company;">Concept asa</ulink> provides
-     additional <ulink
-     url="&url.dbplus.documentation;">documentation</ulink> and <ulink
-     url="&url.dbplus.download;">Demo versions</ulink> of db++ for
-     Linux, some other UNIX versions and Windows95/NT.
+     This extension relies on external client libraries so you have
+     to have a db++ client installed on the system you want to use
+     this extension on.
+    </para>
+    <para>
+     <ulink url="&url.dbplus.company;">Concept asa</ulink> provides
+     <ulink url="&url.dbplus.download;">db++ Demo versions</ulink>
+     and <ulink url="&url.dbplus.documentation;">documentation</ulink> 
+     for Linux, some other UNIX versions. There is also a Windows 
+     version of db++, but this extension doesn't support it (yet).      
     </para>
    </section>
    
    <section id="dbplus.installation">
     <title>Installation</title>
     <para>
-     Creation and installation of this extension requires the db++
-     client libraries and header files to be installed on your system.
+     In order to build this extension yourself you need the db++
+     client libraries and header files to be installed on your system 
+     (these are included in the db++ installation archives by default).
      You have to run <command>configure</command> with option
      <option>--with-dbplus</option> to build this extension.
     </para>
@@ -57,6 +61,30 @@
      <option>--with-dbplus=/your/installation/path</option>.
     </para>
    </section>
+   
+   <section id="dbplus.configuration">
+    <title>Runtime Configuration</title>
+    <para>
+     This extension does not define any configuration directives.
+    </para>
+   </section>
+   
+   <section id="dbplus.resources">
+    <title>Resource Types</title>
+    <section id="dbplus.resources.relation">
+     <title>dbplus_relation</title>
+     <para>
+      Most db++ functions operate on or return
+      <parameter>dbplus_relation</parameter> resources. A
+      <parameter>dbplus_relation</parameter> is a handle to a stored
+      relation or a relation generated as the result of a query.
+     </para>
+    </section>
+   </section>
+
+   <section id="dbplus.constants">
+    <title>Predefined Constants</title>
+
    <section id="dbplus.errorcodes">
     <title>db++ error codes</title>
     <para>
@@ -280,6 +308,8 @@
      </table>
     </para>
    </section>
+   </section>
+
   </partintro>
   
   <refentry id="function.dbplus-add">