Ticket #13014: 13014_doc.diff

docs/topics/cache.txt

@@ -434 +434 @@
 It's perfectly fine to specify more than one argument to identify the fragment.
 Simply pass as many arguments to ``{% cache %}`` as you need.
 
+.. versionadded:: 1.2
+
+If :setting:`USE_I18N` is set to ``True`` then the generated cache keys from
+the per-site middleware cache will include the name of the active
+:term:`language<language code>`. This allows you to easily cache multilingual
+sites without having to create the cache key yourself. For the ``cache``
+template tag you could use the following code to imitate this behaviour::
+
+    {% load i18n %}.
+    {% load cache %}
+    {% get_current_language as LANGUAGE_CODE %}
+    {% cache 60 welcome LANGUAGE_CODE %}
+        {% trans "Welcome to example.com" %}
+    {% endcache %}
+
 The cache timeout can be a template variable, as long as the template variable
 resolves to an integer value. For example, if the template variable
 ``my_timeout`` is set to the value ``600``, then the following two examples are
@@ -813 +828 @@
 runs *first* during the request phase. The ``FetchFromCacheMiddleware`` also
 needs to run after other middleware updates the ``Vary`` header, so
 ``FetchFromCacheMiddleware`` must be *after* any item that does so.
-