From 8050e6282e4daee24758a4a1c6c2fa938957bef2 Mon Sep 17 00:00:00 2001
From: Tim Graham <timograham@gmail.com>
Date: Tue, 16 Jun 2015 12:46:23 -0400
Subject: [PATCH] [1.8.x] Refs #24987 -- Documented that Client.login() rejects
 inactive users.

Backport of fbc618c13cc72b9c2f4c8dfd5ef8b8ab5a5d7caa from master
---
 docs/topics/testing/tools.txt | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/topics/testing/tools.txt b/docs/topics/testing/tools.txt
index d0b63e79ab..4c3b359923 100644
--- a/docs/topics/testing/tools.txt
+++ b/docs/topics/testing/tools.txt
@@ -344,6 +344,13 @@ Use the ``django.test.Client`` class to make requests.
         ``login()`` method to simulate the effect of a user logging into the
         site.
 
+        Inactive users (:attr:`is_active=False
+        <django.contrib.auth.models.User.is_active>`) are not permitted to
+        login as this method is meant to be equivalent to the
+        :func:`~django.contrib.auth.login` view which uses
+        :class:`~django.contrib.auth.forms.AuthenticationForm` and therefore
+        defaults to rejecting users who are inactive.
+
         After you call this method, the test client will have all the cookies
         and session data required to pass any login-based tests that may form
         part of a view.