summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorRamiro Morales <cramm0@gmail.com>2013-08-22 08:25:21 -0300
committerRamiro Morales <cramm0@gmail.com>2013-08-22 08:29:59 -0300
commit26a4c835987d93f845cc2915d08780854a90c587 (patch)
treea5fc2f48e8d127fdfbdf9a849e61a953f2b3c705 /docs/ref
parentff92a6eb5b87c65ca47568e0ca37df949e17feb2 (diff)
[1.6.x] Made description of LANGUAGE_CODE setting more clear.
297f5af222bde02a7cdd005da2e4b00ec81801de from master.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/settings.txt15
1 files changed, 13 insertions, 2 deletions
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index 1916f6377f..46482b80a6 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -1257,11 +1257,22 @@ LANGUAGE_CODE
Default: ``'en-us'``
-A string representing the language code for this installation. This should be
-in standard :term:`language format<language code>`. For example, U.S. English
+A string representing the language code for this installation. This should be in
+standard :term:`language ID format <language code>`. For example, U.S. English
is ``"en-us"``. See also the `list of language identifiers`_ and
:doc:`/topics/i18n/index`.
+:setting:`USE_I18N` must be active to this setting to have any effect.
+
+it serves two purposes:
+
+* If the locale middleware isn't in use, it decides which translation is served
+ to all users.
+* If the locale middleware is active, it provides the fallback translation when
+ no translation exist for a given literal to the user preferred language.
+
+See :ref:`how-django-discovers-language-preference` for more details.
+
.. _list of language identifiers: http://www.i18nguy.com/unicode/language-identifiers.html
.. setting:: LANGUAGE_COOKIE_NAME