From 1a82fc245eb8ac4b131ec02a6ac3e112deb8d5a6 Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Fri, 20 Oct 2017 13:51:21 -0400 Subject: [PATCH] Fixed #28613 -- Doc'd the return value for GenericForeignKey when the related object is deleted. --- docs/ref/contrib/contenttypes.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/ref/contrib/contenttypes.txt b/docs/ref/contrib/contenttypes.txt index e5635ef59e..bc73308b69 100644 --- a/docs/ref/contrib/contenttypes.txt +++ b/docs/ref/contrib/contenttypes.txt @@ -335,6 +335,13 @@ creating a ``TaggedItem``:: >>> t.content_object +If the related object is deleted, the ``content_type`` and ``object_id`` fields +remain set to their original values and the ``GenericForeignKey`` returns +``None``:: + + >>> guido.delete() + >>> t.content_object # returns None + Due to the way :class:`~django.contrib.contenttypes.fields.GenericForeignKey` is implemented, you cannot use such fields directly with filters (``filter()`` and ``exclude()``, for example) via the database API. Because a