Fixed #3469 -- added django.utils documentation for stable bits

Thanks to Rupe and Ramiro Morales for their initial work on this patch.

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

django/utils/feedgenerator.py

@@ -10,7 +10,11 @@ Sample usage:
 ...     description=u"A group weblog by the sharpest minds in online media/journalism/publishing.",
 ...     language=u"en",
 ... )
->>> feed.add_item(title="Hello", link=u"http://www.holovaty.com/test/", description="Testing.")
+>>> feed.add_item(
+...     title="Hello",
+...     link=u"http://www.holovaty.com/test/",
+...     description="Testing."
+... )
 >>> fp = open('test.rss', 'w')
 >>> feed.write(fp, 'utf-8')
 >>> fp.close()

django/utils/translation/trans_real.py

@@ -224,8 +224,9 @@ def get_language():
 def get_language_bidi():
     """
     Returns selected language's BiDi layout.
-    False = left-to-right layout
-    True = right-to-left layout
+    
+    * False = left-to-right layout
+    * True = right-to-left layout
     """
     from django.conf import settings
     

docs/misc/api-stability.txt

@@ -96,7 +96,8 @@ of 1.0. This includes these APIs:
 ``django.utils``
 ----------------
 
-Most of the modules in ``django.utils`` are designed for internal use. Only the following parts of ``django.utils`` can be considered stable:
+Most of the modules in ``django.utils`` are designed for internal use. Only
+the following parts of :ref:`django.utils <ref-utils>` can be considered stable:
 
     - ``django.utils.cache``
     - ``django.utils.datastructures.SortedDict`` -- only this single class; the

docs/ref/index.txt

@@ -21,4 +21,5 @@ API Reference
    signals
    templates/index
    unicode
+   utils
    validators