From 8a55526c154bb2de071b0adb7c7a5b223e68129b Mon Sep 17 00:00:00 2001
From: Matthew Peters <mfp@php.net>
Date: Tue, 26 Jul 2005 15:28:57 +0000
Subject: [PATCH] Alterations to the Requirements section

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@191548 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/sdodasrel/reference.xml | 35 ++++++++++++++++++++++++++++---
 1 file changed, 32 insertions(+), 3 deletions(-)

diff --git a/reference/sdodasrel/reference.xml b/reference/sdodasrel/reference.xml
index c3fefef713..acf2d36a43 100644
--- a/reference/sdodasrel/reference.xml
+++ b/reference/sdodasrel/reference.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
 <reference id="ref.sdo.das.rel">
  <title>SDO Relational Data Access Service Functions</title>
@@ -151,8 +151,37 @@ require_once 'SDO/DAS/Relational.php';
     The Relational DAS requires that the SDO extension be installed.
     The SDO extension requires a version of PHP 5.1, and the 
     Relational DAS requires a recent version that contains 
-    an important fix for PDO. The Relational DAS requires a 
-    version of PHP 5.1 later than 20050711.
+    an important fix for PDO. The most up-to-date information about
+    required levels of PHP should be found in the changelog for the 
+    package on PECL. At the time of writing, though, the Relational 
+    DAS requires the most recent beta level of PHP 5.1, that is 
+    PHP 5.1.0b3.
+   </para>
+   <para>
+    The Relational DAS uses PDO to access the relational database,
+    and so should run with a variety of different relational databases,
+    but at the time of writing has only been tested with MySQL 4.1.
+    On Windows it operates correctly with the php_pdo_mysql driver 
+    that comes with the pre-built binaries in PHP 5.1.0b3. 
+    On Linux it is necessary to have the most up-to-date PDO
+    driver for MySQL. It may be necessary to uninstall the usual
+    driver that would have come from PECL (using 
+    <command>pear uninstall pdo_mysql</command>
+    ) and to enable pdo_mysql when configuring PHP, in order to pick up
+    the recent version built in to PHP.
+   </para>
+
+   <para>
+    The Relational DAS applies changes to the database within
+    a user-delimited transaction: that is, it issues a call to PDO's 
+    <function>beginTransaction</function>
+    before beginning to apply changes, and 
+    <function>commit</function>
+    or 
+    <function>rollback</function>
+    on completion.
+    Whichever database is chosen, the database and the PDO driver
+    for the database must support these calls. 
    </para>
   </section>