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:34:19 -0300
commit9a7d59e8c7e90588fc0301fe09c11fbae9ffe1f3 (patch)
tree90f3198068341cbd25856a189c858609407c03dc /docs/ref
parentbbe2ad3e387a94de1898fb6bab17846b48e82f64 (diff)
[1.5.x] Made description of LANGUAGE_CODE setting more clear.
297f5af222 from master.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/settings.txt18
1 files changed, 16 insertions, 2 deletions
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index 783af7c5ff..64f269a553 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -1228,8 +1228,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 is
-``"en-us"``. See :doc:`/topics/i18n/index`.
+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