Browse files

Added note to docs/db-api.txt about 'depth' being new in Django devel…

…opment version

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 37c66a0 commit a81a6e9abef2302a6bfc3d2bf0c47013bfc87bb3 @adrianholovaty adrianholovaty committed Feb 28, 2007
Showing with 3 additions and 1 deletion.
  1. +3 −1 docs/db-api.txt
@@ -596,7 +596,7 @@ related ``Person`` *and* the related ``City``::
Note that ``select_related()`` does not follow foreign keys that have
-Usually, using ``select_related()`` can vastly improve performance since your
+Usually, using ``select_related()`` can vastly improve performance because your
app can avoid many database calls. However, in situations with deeply nested
sets of relationships ``select_related()`` can sometimes end up following "too
many" relations, and can generate queries so large that they end up being slow.
@@ -608,6 +608,8 @@ follow::
b = Book.objects.select_related(depth=1).get(id=4)
p = # Doesn't hit the database.
c = p.hometown # Requires a database call.
+The ``depth`` argument is new in the Django development version.
``extra(select=None, where=None, params=None, tables=None)``

0 comments on commit a81a6e9

Please sign in to comment.