From 06e65c2d4e014bbf1dc0114d4b654505e684f66c Mon Sep 17 00:00:00 2001
From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Sun, 4 Dec 2011 23:08:35 -0500
Subject: marathon doc updating session including a rewrite of unicode
 paragraphs

---
 lib/sqlalchemy/exc.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

(limited to 'lib/sqlalchemy/exc.py')

diff --git a/lib/sqlalchemy/exc.py b/lib/sqlalchemy/exc.py
index d375807b2..57ddb11ef 100644
--- a/lib/sqlalchemy/exc.py
+++ b/lib/sqlalchemy/exc.py
@@ -63,7 +63,10 @@ class DisconnectionError(SQLAlchemyError):
     """A disconnect is detected on a raw DB-API connection.
 
     This error is raised and consumed internally by a connection pool.  It can
-    be raised by a ``PoolListener`` so that the host pool forces a disconnect.
+    be raised by the :meth:`.PoolEvents.checkout` event 
+    so that the host pool forces a retry; the exception will be caught
+    three times in a row before the pool gives up and raises 
+    :class:`~sqlalchemy.exc.InvalidRequestError` regarding the connection attempt.
 
     """
 
-- 
cgit v1.2.1