diff options
| author | Russell Keith-Magee <russell@keith-magee.com> | 2010-05-09 04:24:21 +0000 |
|---|---|---|
| committer | Russell Keith-Magee <russell@keith-magee.com> | 2010-05-09 04:24:21 +0000 |
| commit | e7e46d1f4b08665df5a073a840b4cdc795952c7c (patch) | |
| tree | 17efe20b8de686861fd1888d228bff9539ddda8a /docs/ref/models | |
| parent | 663d17897eb26851cd41de888af41ec824f32fa6 (diff) | |
Fixed #13455 -- Clarified the interaction of values() and extra(). Thanks to Rupe for the report and draft text.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13145 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs/ref/models')
| -rw-r--r-- | docs/ref/models/querysets.txt | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index 2855794c34..44c4145e9c 100644 --- a/docs/ref/models/querysets.txt +++ b/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 gte ~~~ |