From 16f9b08611ddc5512e16d9fcb6ce405f2962d319 Mon Sep 17 00:00:00 2001 From: Adrian Holovaty Date: Wed, 5 Oct 2005 22:47:36 +0000 Subject: [PATCH] Clarified get_FOO_list part of docs/db-api.txt to specify keyword arguments are also accepted git-svn-id: http://code.djangoproject.com/svn/django/trunk@781 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/db-api.txt | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/db-api.txt b/docs/db-api.txt index e0885da8f0..8a02437aaa 100644 --- a/docs/db-api.txt +++ b/docs/db-api.txt @@ -572,6 +572,9 @@ object in the result list is "truncated" to the given ``type``. * ``"month"`` returns a list of all distinct year/month values for the field. * ``"day"`` returns a list of all distinct year/month/day values for the field. +Additional, optional keyword arguments, in the format described in +"Field lookups" above, are also accepted. + Here's an example, using the ``Poll`` model defined above:: >>> from datetime import datetime @@ -587,6 +590,8 @@ Here's an example, using the ``Poll`` model defined above:: [datetime.datetime(2005, 2, 1), datetime.datetime(2005, 3, 1)] >>> polls.get_pub_date_list('day') [datetime.datetime(2005, 2, 20), datetime.datetime(2005, 3, 20)] + >>> polls.get_pub_date_list('day', question__contains='name') + [datetime.datetime(2005, 3, 20)] ``get_FOO_list()`` also accepts an optional keyword argument ``order``, which should be either ``"ASC"`` or ``"DESC"``. This specifies how to order the