Procházet zdrojové kódy

Corrected GenericRelation's related_query_name manual lookup example.

And changed related_query_name to a singular noun.
Pavel Savchenko před 6 roky
rodič
revize
130192b12b
1 změnil soubory, kde provedl 6 přidání a 6 odebrání
  1. 6 6
      docs/ref/contrib/contenttypes.txt

+ 6 - 6
docs/ref/contrib/contenttypes.txt

@@ -394,21 +394,21 @@ be used to retrieve their associated ``TaggedItems``::
 Defining :class:`~django.contrib.contenttypes.fields.GenericRelation` with
 ``related_query_name`` set allows querying from the related object::
 
-    tags = GenericRelation(TaggedItem, related_query_name='bookmarks')
+    tags = GenericRelation(TaggedItem, related_query_name='bookmark')
 
 This enables filtering, ordering, and other query operations on ``Bookmark``
 from ``TaggedItem``::
 
     >>> # Get all tags belonging to bookmarks containing `django` in the url
-    >>> TaggedItem.objects.filter(bookmarks__url__contains='django')
+    >>> TaggedItem.objects.filter(bookmark__url__contains='django')
     <QuerySet [<TaggedItem: django>, <TaggedItem: python>]>
 
-Of course, if you don't add the reverse relationship, you can do the
+Of course, if you don't add the ``related_query_name``, you can do the
 same types of lookups manually::
 
-    >>> b = Bookmark.objects.get(url='https://www.djangoproject.com/')
-    >>> bookmark_type = ContentType.objects.get_for_model(b)
-    >>> TaggedItem.objects.filter(content_type__pk=bookmark_type.id, object_id=b.id)
+    >>> bookmarks = Bookmark.objects.filter(url__contains='django')
+    >>> bookmark_type = ContentType.objects.get_for_model(Bookmark)
+    >>> TaggedItem.objects.filter(content_type__pk=bookmark_type.id, object_id__in=bookmarks)
     <QuerySet [<TaggedItem: django>, <TaggedItem: python>]>
 
 Just as :class:`~django.contrib.contenttypes.fields.GenericForeignKey`