diff options
Diffstat (limited to 'docs/topics')
| -rw-r--r-- | docs/topics/conditional-view-processing.txt | 8 |
1 files changed, 8 insertions, 0 deletions
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/"<string>"``. 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:: |