cvs: peardoc /en/package/database/mdb2 intro-transaction.xml

kguest		Fri Jan  4 17:29:24 2008 UTC

  Modified files:              
    /peardoc/en/package/database/mdb2	intro-transaction.xml 
  Log:
  some minor corrections regarding grammar and readability
  
http://cvs.php.net/viewvc.cgi/peardoc/en/package/database/mdb2/intro-transaction.xml?r1=1.8&r2=1.9&diff_format=u
Index: peardoc/en/package/database/mdb2/intro-transaction.xml
diff -u peardoc/en/package/database/mdb2/intro-transaction.xml:1.8 peardoc/en/package/database/mdb2/intro-transaction.xml:1.9
--- peardoc/en/package/database/mdb2/intro-transaction.xml:1.8	Tue Sep 26 08:44:53 2006
+++ peardoc/en/package/database/mdb2/intro-transaction.xml	Fri Jan  4 17:29:24 2008
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1" ?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 
 <refentry id="package.database.mdb2.intro-transaction">
  <refnamediv>
@@ -10,13 +10,13 @@
  <refsect1 id="package.database.mdb2.intro-transaction.desc">
   &title.desc;
   <para>
-   PEAR MDB2 default to auto commiting all queries. However using the
+   PEAR MDB2 defaults to auto-committing all queries. However using the
    <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodbeginTransaction">
-   <function>beginTransaction</function></ulink> one can open a new transaction
+   <function>beginTransaction</function></ulink> method one can open a new transaction
    and with the <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodcommit">
    <function>commit</function></ulink> and
    <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodrollback">
-   <function>rollback</function></ulink> a transaction is finished. All of these
+   <function>rollback</function></ulink> methods, a transaction is finished. These
    three methods optionally accept a string name of a savepoint to set, release
    or rollback to respectively. The method
     <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodinTransaction">
@@ -83,8 +83,8 @@
      PEAR MDB2 does not emulate transactions or savepoints. This means that it
      depends on the underlying RDBMS (and in the case of MySQL the storage
      engines used) if transactions will be available in MDB2. Also note that
-     some RDBMS implicitly commit transactions when executing DDL statements
-     (notably exceptions are Oracle and PostgreSQL).
+     some RDBMS implicitly commit transactions when executing DDL statements - 
+     notable exceptions are Oracle and PostgreSQL.
     </para>
    </warning>
 
@@ -103,23 +103,23 @@
    and will return the name. These savepoints are automatically released by the
    <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodcompleteNestedTransaction">
    <function>completeNestedTransaction</function></ulink> method. The name of these
-   automatic savepoints are determined by the "savepoint_format" (default:
-   'MDB2_SAVEPOINT_%s') option and the nested transaction counter.
+   automatic savepoints are determined by the "savepoint_format" option
+   and the nested transaction counter. The "savepoint_format" defaults to
+   'MDB2_SAVEPOINT_%s'.
   </para>
 
   <para>
-   If after initial
-   opening of the nested transaction an unexpected PEAR error is raised on the
+   If, after initially opening a nested transaction, an unexpected PEAR error is raised on the
    MDB2 instance the transaction is rolled back, otherwise it is commited at
    this point. Using the <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodgetNestedTransactionError">
    <function>getNestedTransactionError</function></ulink> method it is possible to check
-   if there has been an error inside the transaction. Alternatively an rollback
-   can be forced using the the
+   if there has been an error inside the transaction. Alternatively a rollback
+   can be forced using the 
    <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodfailNestedTransaction">
    <function>failNestedTransaction</function></ulink>. This method optionally accepts
    a mixed parameter which will set the error to return if the
    <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodgetNestedTransactionError">
-   <function>getNestedTransactionError</function></ulink> method is called as well as
+   <function>getNestedTransactionError</function></ulink> method is called, as well as
    a second boolean parameter that optionally forces an immidiate rollback.
   </para>
 
@@ -163,13 +163,13 @@
   </example>
 
   <para>
-   Finally MDB2 supports setting of the transaction isolation level as per the
+   Finally MDB2 supports setting the transaction isolation level as per the
    SQL 92 standard using the
    <ulink url="http://pear.php.net/package/MDB2/docs/latest/MDB2/MDB2_Driver_Common.html#methodsetTransactionIsolation">
    <function>setTransactionIsolation</function></ulink> method. If a given RDBMS
    does not support a given isolation level but supports a higher more strict
    isolation level, then MDB2 silently uses that higher transaction level. Some
-   RDBMS support additional options which are silently ignored if they are not
+   RDBMS systems support additional options which are silently ignored if they are not
    supported.
   </para>