From 1845c53081ecf3800e9fdc261bae7904d859592f Mon Sep 17 00:00:00 2001
From: Ben Konrath <ben@bagu.org>
Date: Sun, 24 Feb 2013 15:43:56 +0100
Subject: [PATCH] [1.5.x] Fixed #19394 --Added note about auth forms and custom
 user models.

---
 docs/topics/auth/customizing.txt | 2 ++
 docs/topics/auth/default.txt     | 8 ++++++++
 2 files changed, 10 insertions(+)

diff --git a/docs/topics/auth/customizing.txt b/docs/topics/auth/customizing.txt
index f974b5647dd..f15ce847cd9 100644
--- a/docs/topics/auth/customizing.txt
+++ b/docs/topics/auth/customizing.txt
@@ -668,6 +668,8 @@ custom profile fields. This class provides the full implementation of the
 default :class:`~django.contrib.auth.models.User` as an :ref:`abstract model
 <abstract-base-classes>`.
 
+.. _custom-users-and-the-built-in-auth-forms:
+
 Custom users and the built-in auth forms
 ----------------------------------------
 
diff --git a/docs/topics/auth/default.txt b/docs/topics/auth/default.txt
index 6847080c1c2..4072c517716 100644
--- a/docs/topics/auth/default.txt
+++ b/docs/topics/auth/default.txt
@@ -919,6 +919,14 @@ If you don't want to use the built-in views, but want the convenience of not
 having to write forms for this functionality, the authentication system
 provides several built-in forms located in :mod:`django.contrib.auth.forms`:
 
+.. note::
+    The built-in authentication forms make certain assumptions about the user
+    model that they are working with. If you're using a :ref:`custom User model
+    <auth-custom-user>`, it may be necessary to define your own forms for the
+    authentication system. For more information, refer to the documentation
+    about :ref:`using the built-in authentication forms with custom user models
+    <custom-users-and-the-built-in-auth-forms>`.
+
 .. class:: AdminPasswordChangeForm
 
     A form used in the admin interface to change a user's password.