--- BDB/BDB.pm	2007/12/10 04:45:52	1.23
+++ BDB/BDB.pm	2007/12/10 04:57:14	1.24
@@ -136,9 +136,9 @@
 
 All of these are functions. The create functions simply return a new
 object and never block. All the remaining functions all take an optional
-callback as last argument that gets passed the return value. If it is
-missing, then the function will be executed synchronously, and the return
-value is returned as normally.
+callback as last argument. If it is missing, then the function will be
+executed synchronously. In both cases, C<$!> will reflect the return value
+of the function.
 
 BDB functions that cannot block (mostly functions that manipulate
 settings) are method calls on the relevant objects, so the rule of thumb