diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ref/utils.txt | 9 | ||||
| -rw-r--r-- | docs/topics/i18n/internationalization.txt | 7 |
2 files changed, 13 insertions, 3 deletions
diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt index 0b2e386268..1755ee77b3 100644 --- a/docs/ref/utils.txt +++ b/docs/ref/utils.txt @@ -532,15 +532,18 @@ For a complete discussion on the usage of the following see the useful when we want delayed translations to appear as the original string for some reason. -.. function:: override(language) +.. function:: override(language, deactivate=False) .. versionadded:: 1.4 A Python context manager that uses :func:`django.utils.translation.activate` to fetch the translation object for a given language, installing it as the translation object for the - current thread and deinstalls it again on exit with - :func:`django.utils.translation.deactivate`. + current thread and reinstall the previous active language on exit. + Optionally it can simply deinstall the temporary translation on exit with + :func:`django.utils.translation.deactivate` if the deactivate argument is + True. If you pass None as the language argument, a NullTranslations() + instance is installed while the context is active. .. function:: get_language() diff --git a/docs/topics/i18n/internationalization.txt b/docs/topics/i18n/internationalization.txt index 176ad7fb43..dbeb77c879 100644 --- a/docs/topics/i18n/internationalization.txt +++ b/docs/topics/i18n/internationalization.txt @@ -512,6 +512,13 @@ You can use multiple expressions inside a single ``blocktrans`` tag:: .. note:: The previous more verbose format is still supported: ``{% blocktrans with book|title as book_t and author|title as author_t %}`` +.. versionchanged:: 1.4 + +If resolving one of the block arguments fails, blocktrans will fall back to +the default language by deactivating the currently active language +temporarily with the :func:`~django.utils.translation.deactivate_all` +function. + This tag also provides for pluralization. To use it: * Designate and bind a counter value with the name ``count``. This value will |