Browse files

Fixed #13455 -- Clarified the interaction of values() and extra(). Th…

…anks to Rupe for the report and draft text.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 663d178 commit e7e46d1f4b08665df5a073a840b4cdc795952c7c @freakboy3742 freakboy3742 committed May 9, 2010
Showing with 6 additions and 1 deletion.
  1. +6 −1 docs/ref/models/querysets.txt
@@ -418,6 +418,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
@@ -1383,7 +1388,7 @@ SQL equivalent::
SELECT ... WHERE id > 4;
-.. fieldlookup:: gte
+.. fieldlookup:: gte

0 comments on commit e7e46d1

Please sign in to comment.