From fe0a15b6c9b5780df765a9c294d81d2b741b0d56 Mon Sep 17 00:00:00 2001
From: Timo Graham <timograham@gmail.com>
Date: Sat, 29 Jan 2011 02:01:43 +0000
Subject: [PATCH] Fixed #14993 - Improved docs for ModelAdmin.filter_horizontal
 adding that it's for ManyToManyFields; thanks jammon for the suggestion.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@15357 bcc190cf-cafb-0310-a4f2-bffc1f526a37
---
 docs/ref/contrib/admin/index.txt | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt
index 34a2348723..2815b5ddf2 100644
--- a/docs/ref/contrib/admin/index.txt
+++ b/docs/ref/contrib/admin/index.txt
@@ -263,15 +263,20 @@ subclass::
 
 .. attribute:: ModelAdmin.filter_horizontal
 
-    Use a nifty unobtrusive JavaScript "filter" interface instead of the
-    usability-challenged ``<select multiple>`` in the admin form. The value is
-    a list of fields that should be displayed as a horizontal filter interface.
-    See ``filter_vertical`` to use a vertical interface.
+    By default, a :class:`~django.db.models.ManyToManyField` is displayed in
+    the admin site with a ``<select multiple>``. However, multiple-select boxes
+    can be difficult to use when selecting many items. Adding a
+    :class:`~django.db.models.ManyToManyField` to this list will instead use
+    a nifty unobtrusive JavaScript "filter" interface that allows searching
+    within the options. The unselected and selected options appear in two boxes
+    side by side. See :attr:`~ModelAdmin.filter_vertical` to use a vertical
+    interface.
 
 .. attribute:: ModelAdmin.filter_vertical
 
-    Same as ``filter_horizontal``, but is a vertical display of the filter
-    interface.
+    Same as :attr:`~ModelAdmin.filter_horizontal`, but uses a vertical display
+    of the filter interface with the box of unselected options appearing above
+    the box of selected options.
 
 .. attribute:: ModelAdmin.form