Added a few notes about list_display to docs/model-api.txt

git-svn-id: http://code.djangoproject.com/svn/django/trunk@649 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2005-09-20 02:37:39 +00:00
parent 473306a658
commit 1d65ba62db
1 changed files with 10 additions and 2 deletions

View File

@ -786,8 +786,11 @@ object, which takes the following parameters. All are optional.
There are a few special cases that do other things besides displaying the There are a few special cases that do other things besides displaying the
contents of the given fields: contents of the given fields:
* If the field given has a relationship, that relationship is * If the field given is a ``ForeignKey``, the ``repr()`` of the related
followed and the ``repr()`` of the related object is displayed. object will be displayed.
* ``ManyToManyField`` fields aren't supported, because that would
entail executing a separate SQL statement for each row in the table.
* If the field is a ``BooleanField``, a "on" or "off" icon will * If the field is a ``BooleanField``, a "on" or "off" icon will
be displayed instead of ``True`` or ``False``. be displayed instead of ``True`` or ``False``.
@ -797,6 +800,11 @@ object, which takes the following parameters. All are optional.
``short_description`` function attribute, for use as the header for ``short_description`` function attribute, for use as the header for
the field. the field.
* Use the string ``"__repr__"`` to output the representation of the
object, according to your model's ``__repr__()`` function. If you
don't define ``list_display``, Django will use the ``__repr__`` by
default.
See the example below. See the example below.
``list_filter`` ``list_filter``