--- PApp-SQL/SQL.pm	2002/04/07 16:23:56	1.23
+++ PApp-SQL/SQL.pm	2002/04/11 01:02:10	1.24
@@ -46,7 +46,7 @@
 BEGIN {
    use base qw(Exporter DynaLoader);
 
-   $VERSION = 0.13;
+   $VERSION = 0.131;
    @EXPORT = qw(
          sql_exec  sql_fetch  sql_fetchall  sql_exists sql_insertid $sql_exec
          sql_uexec sql_ufetch sql_ufetchall sql_uexists
@@ -78,8 +78,7 @@
 =item $PApp::SQL::DBH
 
 The default database handle used by this module if no C<$DBH> was
-specified as argument and no C<$DBH> is found in the current package. See
-C<sql_exec> for a discussion.
+specified as argument. See C<sql_exec> for a discussion.
 
 =item $PApp::SQL::Database
 
@@ -169,9 +168,19 @@
 anymore, as the subsequent call will re-use the handle.
 
 The database handle (the first argument) is optional. If it is missing,
-C<sql_exec> first tries to use the variable C<$DBH> in the current (=
-calling) package and, if that fails, it tries to use database handle in
-C<$PApp::SQL::DBH>, which you can set before calling these functions.
+it tries to use database handle in C<$PApp::SQL::DBH>, which you can set
+before calling these functions. NOTICE: future and former versions of
+PApp::SQL might also look up the global variable C<$DBH> in the callers
+package.
+
+=begin comment
+
+If it is missing, C<sql_exec> first tries to use the variable C<$DBH>
+in the current (= calling) package and, if that fails, it tries to use
+database handle in C<$PApp::SQL::DBH>, which you can set before calling
+these functions.
+
+=end comment
 
 The actual return value from the C<$sth->execute> call is stored in the
 package-global (and exported) variable C<$sql_exec>.