[svn:DBD-Pg] r11527 - DBD-Pg/trunk

Author: turnstep
Date: Sun Jul 13 07:12:22 2008
New Revision: 11527

Modified:
   DBD-Pg/trunk/Pg.pm

Log:
More documentation tweaks.


Modified: DBD-Pg/trunk/Pg.pm
==============================================================================
--- DBD-Pg/trunk/Pg.pm	(original)
+++ DBD-Pg/trunk/Pg.pm	Sun Jul 13 07:12:22 2008
@@ -2146,7 +2146,10 @@
 
 =item B<Executed> (boolean, read-only)
 
-Implemented by DBI, no driver-specific impact.
+Indicates if a handle has been executed. For database handles, this value is true after the C<do()> method has been called, or 
+when one of the child statement handles has issued an execute(). Issuing a C<commit> or C<rollback> always resets the 
+attribute to false for database handles. For statement handles, any call to C<execute()> or it variants will flip the value to 
+true for the lifetime of the statement handle.
 
 =item B<Type> (scalar)
 
@@ -2168,11 +2171,15 @@
 
 =item B<PrintError> (boolean, inherited)
 
-Implemented by DBI, no driver-specific impact.
+Forces database errors to also generate warnings, which can then be filtered with methods such as 
+locally redefining $SIG{__WARN__} or using modules such as CGI::Carp. This attribute is on 
+by default.
 
 =item B<RaiseError> (boolean, inherited)
 
-Implemented by DBI, no driver-specific impact.
+Forces errors to always raise an exception. Although it defaults to off, it is recommended that this 
+be turned on, as the alternative is to check the return value of every method (prepare, execute, fetch, etc.) 
+to check for any problems. See the DBI docs for more information.
 
 =item B<HandleError> (boolean, inherited)
 
@@ -2642,9 +2649,9 @@
 
   $rc = $dbh->ping;
 
-This driver supports the C<ping> method, which can be used to check the validity
-of a database handle. The value returned is either 0, indicating that the 
-connection is no longer valid, or a positive integer, indicating the following:
+This C<ping> method is used to check the validity of a database handle. The value returned is 
+either 0, indicating that the connection is no longer valid, or a positive integer, indicating 
+the following:
 
   Value    Meaning
   --------------------------------------------------