Ticket #14757: 14757.diff

docs/ref/models/querysets.txt

@@ -786 +786 @@
 
             SELECT * FROM blog_entry WHERE id IN (3, 4, 5, 20);
 
+        Example with ``tables``::
+
+            Entry.objects.extra(tables=['blog_blog'], where=["name='Beatles Blog'"])
+
+        ...translates (roughly) into the following SQL::
+
+            SELECT blog_entry.* FROM blog_entry, blog_blog WHERE name='Beatles Blog';
+
+        In the previous case, a more portable solution would be to simply use ``filter()``::
+
+            Entry.objects.filter(blog__name='Beatles Blog')
+
         Be careful when using the ``tables`` parameter if you're specifying
         tables that are already used in the query. When you add extra tables
         via the ``tables`` parameter, Django assumes you want that table included