summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorFlorian Apolloner <florian@apolloner.eu>2020-12-19 15:38:32 +0100
committerMariusz Felisiak <felisiak.mariusz@gmail.com>2021-01-07 13:00:53 +0100
commit2d6179c819010f6a9d00835d5893c4593c0b85a0 (patch)
tree98f895cbf0df6ba3f8b52487401c8f34c0d4f355 /docs
parent3eb98743dcaa0b7abd2d5832cba8cc9cb586a964 (diff)
Fixed #32191 -- Made CookieStorage use RFC 6265 compliant format.
Co-authored-by: Craig Smith <hello@craigiansmith.com.au>
Diffstat (limited to 'docs')
-rw-r--r--docs/internals/deprecation.txt3
-rw-r--r--docs/ref/contrib/messages.txt4
-rw-r--r--docs/releases/3.2.txt9
3 files changed, 16 insertions, 0 deletions
diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt
index b53552bb0a..d0d9c45f7e 100644
--- a/docs/internals/deprecation.txt
+++ b/docs/internals/deprecation.txt
@@ -31,6 +31,9 @@ details on these changes.
* ``django.core.cache.backends.memcached.MemcachedCache`` will be removed.
+* Support for the pre-Django 3.2 format of messages used by
+ ``django.contrib.messages.storage.cookie.CookieStorage`` will be removed.
+
.. _deprecation-removed-in-4.0:
4.0
diff --git a/docs/ref/contrib/messages.txt b/docs/ref/contrib/messages.txt
index 2f05ce7370..ec8032eb10 100644
--- a/docs/ref/contrib/messages.txt
+++ b/docs/ref/contrib/messages.txt
@@ -69,6 +69,10 @@ Django provides three built-in storage classes in
to prevent manipulation) to persist notifications across requests. Old
messages are dropped if the cookie data size would exceed 2048 bytes.
+ .. versionchanged:: 3.2
+
+ Messages format was changed to the :rfc:`6265` compliant format.
+
.. class:: storage.fallback.FallbackStorage
This class first uses ``CookieStorage``, and falls back to using
diff --git a/docs/releases/3.2.txt b/docs/releases/3.2.txt
index 6850774312..a2aa1bb80c 100644
--- a/docs/releases/3.2.txt
+++ b/docs/releases/3.2.txt
@@ -702,6 +702,10 @@ Miscellaneous
* The minimum supported version of SQLite is increased from 3.8.3 to 3.9.0.
+* :class:`~django.contrib.messages.storage.cookie.CookieStorage` now stores
+ messages in the :rfc:`6265` compliant format. Support for cookies that use
+ the old format remains until Django 4.1.
+
.. _deprecated-features-3.2:
Features deprecated in 3.2
@@ -737,3 +741,8 @@ Miscellaneous
deprecated as ``python-memcached`` has some problems and seems to be
unmaintained. Use ``django.core.cache.backends.memcached.PyMemcacheCache``
or ``django.core.cache.backends.memcached.PyLibMCCache`` instead.
+
+* The format of messages used by
+ ``django.contrib.messages.storage.cookie.CookieStorage`` is different from
+ the format generated by older versions of Django. Support for the old format
+ remains until Django 4.1.