summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2015-10-29 18:56:57 -0400
committerTim Graham <timograham@gmail.com>2015-10-30 10:26:54 -0400
commit69239c0f968ee55cb9ca1e31323fb696db0c2aec (patch)
treebe3529d08322490e23f2fbefb15c1b90f99ad7d3 /docs
parent9ae8da0e3761c2823ca166336950fd3fef828a88 (diff)
Fixed #21422 -- Documented that prefetch_related() results must be homogeneous.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/models/querysets.txt5
1 files changed, 4 insertions, 1 deletions
diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt
index 0887e94729..61bf4afa2c 100644
--- a/docs/ref/models/querysets.txt
+++ b/docs/ref/models/querysets.txt
@@ -868,7 +868,10 @@ many-to-many and many-to-one objects, which cannot be done using
``select_related``, in addition to the foreign key and one-to-one relationships
that are supported by ``select_related``. It also supports prefetching of
:class:`~django.contrib.contenttypes.fields.GenericRelation` and
-:class:`~django.contrib.contenttypes.fields.GenericForeignKey`.
+:class:`~django.contrib.contenttypes.fields.GenericForeignKey`, however, it
+must be restricted to a homogeneous set of results. For example, prefetching
+objects referenced by a ``GenericForeignKey`` is only supported if the query
+is restricted to one ``ContentType``.
For example, suppose you have these models::