Changeset 6805

Timestamp:

12/01/07 13:52:53 (1 year ago)

Author:

ubernostrum

Message:

Fixed #4819: documented the need to call authenticate() before login(), based on a patch from Davd Krauth.

Files:

• django/trunk/docs/authentication.txt (modified) (1 diff)

django/trunk/docs/authentication.txt

@@ -337 +337 @@
-        else:
-            # Return an 'invalid login' error message.
+
+.. admonition:: Calling ``authenticate()`` first
+    
+    When you're manually logging a user in, you *must* call
+    ``authenticate()`` before you call ``login()``; ``authenticate()``
+    sets an attribute on the ``User`` noting which authentication
+    backend successfully authenticated that user (see the `backends
+    documentation`_ for details), and this information is needed later
+    during the login process.
+    
+.. _backends documentation: #other-authentication-sources
-
-Manually checking a user's password