p31829507
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Fixed #7546 -- Fixed an incorrect example in the docs that was misleading some 

people. Patch from Dan Watson.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8232 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Malcolm Tredinnick 2008-08-08 16:00:26 +00:00
parent 90b6e1438f
commit 169b889486
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/db-api.txt
View File

@ -1708,8 +1708,8 @@ When you are filtering an object based on a ``ManyToManyField`` or a reverse
interested in. Consider the ``Blog``/``Entry`` relationship (``Blog`` to interested in. Consider the ``Blog``/``Entry`` relationship (``Blog`` to
``Entry`` is a one-to-many relation). We might be interested in finding blogs ``Entry`` is a one-to-many relation). We might be interested in finding blogs
that have an entry which has both *"Lennon"* in the headline and was published that have an entry which has both *"Lennon"* in the headline and was published
today. Or we might want to find blogs that have an entry with *"Lennon"* in in 2008. Or we might want to find blogs that have an entry with *"Lennon"* in
the headline as well as an entry that was published today. Since there are the headline as well as an entry that was published in 2008. Since there are
multiple entries associated with a single ``Blog``, both of these queries are multiple entries associated with a single ``Blog``, both of these queries are
possible and make sense in some situations. possible and make sense in some situations.
@ -1728,16 +1728,16 @@ earlier ``filter()`` call.
That may sound a bit confusing, so hopefully an example will clarify. To That may sound a bit confusing, so hopefully an example will clarify. To
select all blogs that contains entries with *"Lennon"* in the headline and select all blogs that contains entries with *"Lennon"* in the headline and
were published today, we would write:: were published in 2008, we would write::
Blog.objects.filter(entry__headline__contains='Lennon', Blog.objects.filter(entry__headline__contains='Lennon',
entry__pub_date=datetime.date.today()) entry__pub_date__year=2008)
To select all blogs that contain an entry with *"Lennon"* in the headline To select all blogs that contain an entry with *"Lennon"* in the headline
**as well as** an entry that was published today, we would write:: **as well as** an entry that was published in 2008, we would write::
Blog.objects.filter(entry__headline__contains='Lennon').filter( Blog.objects.filter(entry__headline__contains='Lennon').filter(
entry__pub_date=datetime.date.today()) entry__pub_date__year=2008)
In this second example, the first filter restricted the queryset to all those In this second example, the first filter restricted the queryset to all those
blogs linked to that particular type of entry. The second filter restricted blogs linked to that particular type of entry. The second filter restricted