Added translation.override() context manager to docs.

1 files changed, 11 insertions, 0 deletions

diff --git a/docs/topics/i18n/translation.txt b/docs/topics/i18n/translation.txt
index 89b9250add..354905ab78 100644
--- a/docs/topics/i18n/translation.txt
+++ b/docs/topics/i18n/translation.txt
@@ -1756,6 +1756,7 @@ will affect code running in the same thread.
 For example::
 
     from django.utils import translation
+
     def welcome_translated(language):
         cur_language = translation.get_language()
         try:
@@ -1774,6 +1775,16 @@ which returns the language used in the current thread,
 for the current thread, and ``django.utils.translation.check_for_language()``
 which checks if the given language is supported by Django.
 
+To help write more concise code, there is also a context manager
+``django.utils.translation.override()`` that stores the current language on
+enter and restores it on exit. With it, the above example becomes::
+
+    from django.utils import tranlations
+
+    def welcome_translated(language):
+        with translation.override(language):
+            return translation.ugettext('welcome')
+
 Language cookie
 ---------------