From 4e47df9de20ab12070fcb92ef2176ece7847e5f5 Mon Sep 17 00:00:00 2001
From: Julien Phalip <jphalip@gmail.com>
Date: Mon, 12 Sep 2011 07:12:28 +0000
Subject: [PATCH] Fixed #16291 -- Documented that TypedChoiceField does not
 coerce empty_value. Thanks to vanschelven and taavi223.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16820 bcc190cf-cafb-0310-a4f2-bffc1f526a37
---
 docs/ref/forms/fields.txt | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index 33aa62bffb..dbb10346fe 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -379,7 +379,9 @@ Takes extra arguments:
 .. attribute:: TypedChoiceField.empty_value
 
     The value to use to represent "empty." Defaults to the empty string;
-    ``None`` is another common choice here.
+    ``None`` is another common choice here. Note that this value will not be
+    coerced by the function given in the ``coerce`` argument, so choose it
+    accordingly.
 
 ``DateField``
 ~~~~~~~~~~~~~