diff options
| author | Claude Paroz <claude@2xlibre.net> | 2012-03-29 18:39:21 +0000 |
|---|---|---|
| committer | Claude Paroz <claude@2xlibre.net> | 2012-03-29 18:39:21 +0000 |
| commit | 31e84e40f8e4c5e6d4fb4bd9276d2e535545fa33 (patch) | |
| tree | 1c99aec1404e7343889fba16584fbd0b80ca6e56 /docs | |
| parent | 159d1be6567a3696468b77c64169f4f5a5429c14 (diff) | |
Fixed #17870 -- Documented that EmailField default max_length of 75 does not comply with RFCs 3696/5321. Thanks Rotund for the report and the patch and Russell Keith-Magee for the review.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17826 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/models/fields.txt | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index 36bf60e9ac..8c6a2c9d35 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -481,6 +481,15 @@ The admin represents this as an ``<input type="text">`` (a single-line input). A :class:`CharField` that checks that the value is a valid email address. +.. admonition:: Incompliance to RFCs + + The default 75 character ``max_length`` is not capable of storing all + possible RFC3696/5321-compliant email addresses. In order to store all + possible valid email addresses, a ``max_length`` of 254 is required. + The default ``max_length`` of 75 exists for historical reasons. The + default has not been changed in order to maintain backwards + compatibility with existing uses of :class:`EmailField`. + ``FileField`` ------------- |