Fixed #23762 -- clarified CACHE_MIDDLEWARE_ANONYMOUS_ONLY deprecation in docs

This commit is contained in:
Kenneth Kam 2015-02-22 17:46:15 +00:00 committed by Tim Graham
parent 1306cd1e8a
commit e83aba0e2c
2 changed files with 9 additions and 5 deletions

View File

@ -1040,10 +1040,11 @@ If necessary, you can temporarily disable auto-escaping with
``CACHE_MIDDLEWARE_ANONYMOUS_ONLY`` setting ``CACHE_MIDDLEWARE_ANONYMOUS_ONLY`` setting
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
``CacheMiddleware`` used to provide a way to cache requests only if they ``CacheMiddleware`` and ``UpdateCacheMiddleware`` used to provide a way to
weren't made by a logged-in user. This mechanism was largely ineffective cache requests only if they weren't made by a logged-in user. This mechanism
because the middleware correctly takes into account the ``Vary: Cookie`` HTTP was largely ineffective because the middleware correctly takes into account the
header, and this header is being set on a variety of occasions, such as: ``Vary: Cookie`` HTTP header, and this header is being set on a variety of
occasions, such as:
* accessing the session, or * accessing the session, or
* using CSRF protection, which is turned on by default, or * using CSRF protection, which is turned on by default, or

View File

@ -1723,7 +1723,10 @@ removed in Django 1.8 (please see the :ref:`deprecation timeline
* The module ``django.test._doctest`` is removed. * The module ``django.test._doctest`` is removed.
* The ``CACHE_MIDDLEWARE_ANONYMOUS_ONLY`` setting is removed. * The ``CACHE_MIDDLEWARE_ANONYMOUS_ONLY`` setting is removed. This change
affects both ``django.middleware.cache.CacheMiddleware`` and
``django.middleware.cache.UpdateCacheMiddleware`` despite the lack of a
deprecation warning in the latter class.
* Usage of the hard-coded *Hold down "Control", or "Command" on a Mac, to select * Usage of the hard-coded *Hold down "Control", or "Command" on a Mac, to select
more than one.* string to override or append to user-provided ``help_text`` in more than one.* string to override or append to user-provided ``help_text`` in