Browse files

[1.1.X] Fixed #13455 -- Clarified the interaction of values() and ext…

…ra(). Thanks to Rupe for the report and draft text.

Backport of r13145 from trunk.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 0711e10 commit a1421336d79e82737c359db4b18f81a962442a21 @freakboy3742 freakboy3742 committed May 9, 2010
Showing with 6 additions and 1 deletion.
  1. +6 −1 docs/ref/models/querysets.txt
@@ -414,6 +414,11 @@ A couple of subtleties that are worth mentioning:
* When using ``values()`` together with ``distinct()``, be aware that
ordering can affect the results. See the note in the `distinct()`_
section, above, for details.
+ * If you use a ``values()`` clause after an ``extra()`` clause,
+ any fields defined by a ``select`` argument in the ``extra()``
+ must be explicitly included in the ``values()`` clause. However,
+ if the ``extra()`` clause is used after the ``values()``, the
+ fields added by the select will be included automatically.
.. versionadded:: 1.0
@@ -1330,7 +1335,7 @@ SQL equivalent::
SELECT ... WHERE id > 4;
-.. fieldlookup:: gte
+.. fieldlookup:: gte

0 comments on commit a142133

Please sign in to comment.