Author: timbo
Date: Tue Feb 24 07:06:15 2004
New Revision: 140

Modified:
   dbi/trunk/DBI.pm
Log:
Clarify that drivers may not provide full warning details
unless PrintWarn is true.


Modified: dbi/trunk/DBI.pm
==============================================================================
--- dbi/trunk/DBI.pm    (original)
+++ dbi/trunk/DBI.pm    Tue Feb 24 07:06:15 2004
@@ -2974,6 +2974,13 @@
 See also L</set_err> for how warnings are recorded and L</HandleSetErr>
 for how to influence it.
 
+Fetching the full details of warnings can require an extra round-trip
+to the database server for some drivers. In which case the driver
+may opt to only fetch the full details of warnings if the C<PrintWarn>
+attribute is true. If C<PrintWarn> is false then these drivers should
+still indicate the fact that there were warnings by setting the
+warning string to, for example: "3 warnings".
+
 =item C<PrintError> (boolean, inherited)
 
 The C<PrintError> attribute can be used to force errors to generate warnings (using

Reply via email to