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:27:04 -0300
commit297f5af222bde02a7cdd005da2e4b00ec81801de (patch)
tree2113556fc9bf3b4a1efc2c3c923e88707732712a /docs/ref
parent8cd8742981020e315acc4e70bdf3613fcf68e3a8 (diff)
Made description of LANGUAGE_CODE setting more clear.
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 424f7d5795..738ae32cdb 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -1290,11 +1290,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