Doc updated

diff --git a/lib/sqlalchemy/engine/__init__.py b/lib/sqlalchemy/engine/__init__.py
index ac53fa637f522b33927dae4d2901b350e8facd4c..668cfee90252f22691556cc89b1bbe9fd7d5eb3f 100644 (file)
--- a/lib/sqlalchemy/engine/__init__.py
+++ b/lib/sqlalchemy/engine/__init__.py
@@ -171,8 +171,9 @@ def create_engine(*args, **kwargs):
 
     :param echo_pool=False: if True, the connection pool will log
         all pool disconnects and whether reconnection attempts have exhausted 
-        or not to the logging stream, which defaults to sys.stdout. This flag 
-        ultimately controls a Python logger; see :ref:`dbengine_logging` for 
+        or not to the logging stream, which defaults to sys.stdout. This also logs
+        pool checkins/checkouts, but for that you need to set your log level to debug.
+        This flag ultimately controls a Python logger; see :ref:`dbengine_logging` for 
         information on how to configure logging directly.
 
     :param empty_in_strategy:  The SQL compilation strategy to use when

diff --git a/lib/sqlalchemy/pool/base.py b/lib/sqlalchemy/pool/base.py
index 7bab2e532d05f9962d1a7eb5cef09d8c55d86179..a3d64fc58b3b67f98a44f7f12211451b936fe64c 100644 (file)
--- a/lib/sqlalchemy/pool/base.py
+++ b/lib/sqlalchemy/pool/base.py
@@ -107,8 +107,9 @@ class Pool(log.Identified):
 
         :param echo: if True, the connection pool will log
           all pool disconnects and whether reconnection attempts have exhausted
-          or not to the logging stream, which defaults to sys.stdout. Echoing
-          can also be achieved by enabling logging for the "sqlalchemy.pool"
+          or not to the logging stream, which defaults to sys.stdout. This also logs
+          pool checkins/checkouts, but for that you need to set your log level to debug.
+          Echoing can also be achieved by enabling logging for the "sqlalchemy.pool"
           namespace. Defaults to False.
 
         :param use_threadlocal: If set to True, repeated calls to