Grammar cleanups for recent documentation and docstring changes.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@1209 bcc190cf-cafb-0310-a4f2-bffc1f526a37

2 files changed, 35 insertions, 11 deletions

diff --git a/docs/i18n.txt b/docs/i18n.txt
index 3ed95007fc..2bf5535f0a 100644
--- a/docs/i18n.txt
+++ b/docs/i18n.txt
@@ -426,18 +426,21 @@ Notes:
       Django uses the base language. For example, if a user specifies ``de-at``
       (Austrian German) but Django only has ``de`` available, Django uses
       ``de``.
-    * only languages listed in the LANGUAGES setting can be selected. So if you want
-      to restrict the language selection to a subset of provided languages (because
-      your appliaction doesn't provide all those languages), just set it to a list
-      of languages like this::
+    * Only languages listed in the `LANGUAGES setting`_ can be selected. If
+      you want to restrict the language selection to a subset of provided
+      languages (because your appliaction doesn't provide all those languages),
+      set ``LANGUAGES`` to a list of languages. For example::
 
           LANGUAGES = (
             ('de', _('German')),
             ('en', _('English')),
           )
 
-      This would restrict the available languages for automatic selection to German
-      and English (and any sublanguage of those, like de-ch or en-us).
+      This example restricts languages that are available for automatic
+      selection to German and English (and any sublanguage, like de-ch or
+      en-us).
+
+      .. _LANGUAGES setting: http://www.djangoproject.com/documentation/settings/#languages
 
 Once ``LocaleMiddleware`` determines the user's preference, it makes this
 preference available as ``request.LANGUAGE_CODE`` for each `request object`_.
diff --git a/docs/settings.txt b/docs/settings.txt
index d2f6ffcdb5..fbce44807a 100644
--- a/docs/settings.txt
+++ b/docs/settings.txt
@@ -403,12 +403,33 @@ in standard language format. For example, U.S. English is ``"en-us"``. See the
 LANGUAGES
 ---------
 
-Default: a list of available languages and their name
+Default: A tuple of all available languages. Currently, this is::
 
-This is a list of two-tuples with language code and language name that are available
-for language selection. See the `internationalization docs`_ for details. It usually
-isn't defined, only if you want to restrict language selection to a subset of the
-django-provided languages you need to set it.
+    LANGUAGES = (
+        ('bn', _('Bengali')),
+        ('cs', _('Czech')),
+        ('cy', _('Welsh')),
+        ('de', _('German')),
+        ('en', _('English')),
+        ('es', _('Spanish')),
+        ('fr', _('French')),
+        ('gl', _('Galician')),
+        ('it', _('Italian')),
+        ('no', _('Norwegian')),
+        ('pt-br', _('Brazilian')),
+        ('ro', _('Romanian')),
+        ('ru', _('Russian')),
+        ('sk', _('Slovak')),
+        ('sr', _('Serbian')),
+        ('zh-cn', _('Simplified Chinese')),
+    )
+
+A tuple of two-tuples in the format (language code, language name). This
+specifies which languages are available for language selection. See the
+`internationalization docs`_ for details.
+
+Generally, the default value should suffice. Only set this setting if you want
+to restrict language selection to a subset of the Django-provided languages.
 
 MANAGERS
 --------