Merge from stable

1 files changed, 7 insertions, 1 deletions

diff --git a/passlib/context.py b/passlib/context.py
index bab1ced..6958ac8 100644
--- a/passlib/context.py
+++ b/passlib/context.py
@@ -2329,7 +2329,7 @@ class LazyCryptContext(CryptContext):
     """CryptContext subclass which doesn't load handlers until needed.
 
     This is a subclass of CryptContext which takes in a set of arguments
-    exactly like CryptContext, but won't load any handlers
+    exactly like CryptContext, but won't import any handlers
     (or even parse its arguments) until
     the first time one of its methods is accessed.
 
@@ -2368,6 +2368,12 @@ class LazyCryptContext(CryptContext):
     but using :func:`!onload()` to provide dynamic configuration
     at *application-run* time.
 
+    .. note:: 
+        This class is only useful if you're referencing handler objects by name,
+        and don't want them imported until runtime. If you want to have the config
+        validated before your application runs, or are passing in already-imported
+        handler instances, you should use :class:`CryptContext` instead.
+
     .. versionadded:: 1.4
     """
     _lazy_kwds = None