Commit f505bd6e authored by Malcolm Tredinnick's avatar Malcolm Tredinnick
Browse files

Documented that GenericForeignKey fields can't be used transparently in

filters. Refs #3006. Patch from rmyers.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8417 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent 7c607186
Loading
Loading
Loading
Loading
+10 −0
Original line number Diff line number Diff line
@@ -227,6 +227,16 @@ creating a ``TaggedItem``::
    >>> t.content_object
    <User: Guido>

Due to the way ``GenericForeignKey`` is implemeneted, you cannot use such
fields directly with filters (``filter()`` and ``exclude()``, for example) via
the database API. They aren't normal field objects. These examples will *not*
work::

	# This will fail
	>>> TaggedItem.objects.filter(content_object=guido)
	# This will also fail
	>>> TaggedItem.objects.get(content_object=guido)

Reverse generic relations
-------------------------