From 4ef0e019b7dd3d2bf93b5c705b3b7df9cdb77561 Mon Sep 17 00:00:00 2001 From: Kevin Christopher Henry Date: Thu, 1 Sep 2016 09:32:20 -0400 Subject: Fixed #27083 -- Added support for weak ETags. --- docs/releases/1.11.txt | 3 +++ docs/topics/conditional-view-processing.txt | 8 ++++++++ 2 files changed, 11 insertions(+) (limited to 'docs') diff --git a/docs/releases/1.11.txt b/docs/releases/1.11.txt index afd24e6613..49d0516b99 100644 --- a/docs/releases/1.11.txt +++ b/docs/releases/1.11.txt @@ -491,6 +491,9 @@ Miscellaneous * The admin's widget for ``IntegerField`` uses ``type="number"`` rather than ``type="text"``. +* ETags are now parsed according to the :rfc:`7232` Conditional Requests + specification rather than the syntax from :rfc:`2616`. + .. _deprecated-features-1.11: Features deprecated in 1.11 diff --git a/docs/topics/conditional-view-processing.txt b/docs/topics/conditional-view-processing.txt index 7efd8ac636..7398b3fd05 100644 --- a/docs/topics/conditional-view-processing.txt +++ b/docs/topics/conditional-view-processing.txt @@ -66,6 +66,14 @@ last time the resource was modified, or ``None`` if the resource doesn't exist. The function passed to the ``etag`` decorator should return a string representing the `ETag`_ for the resource, or ``None`` if it doesn't exist. +.. versionchanged:: 1.11 + + In older versions, the return value from ``etag_func()`` was interpreted as + the unquoted part of the ETag. That prevented the use of weak ETags, which + have the format ``W/""``. The return value is now expected to be + an ETag as defined by the specification (including the quotes), although + the unquoted format is also accepted for backwards compatibility. + Using this feature usefully is probably best explained with an example. Suppose you have this pair of models, representing a simple blog system:: -- cgit v1.3