Browse files

Fixed #20408 -- Clarified that values_list() doesn't return a list.

Thanks marktranchant, bmispelon, and alextreme.
  • Loading branch information...
1 parent 0b07416 commit 7b85ef9dfb83bd2f2cde46b9836b9fd12a033b26 @aaugustin aaugustin committed May 18, 2013
Showing with 5 additions and 0 deletions.
  1. +5 −0 docs/ref/models/querysets.txt
@@ -544,6 +544,11 @@ It is an error to pass in ``flat`` when there is more than one field.
If you don't pass any values to ``values_list()``, it will return all the
fields in the model, in the order they were declared.
+Note that this method returns a ``ValuesListQuerySet``. This class behaves
+like a list. Most of the time this is enough, but if you require an actual
+Python list object, you can simply call ``list()`` on it, which will evaluate
+the queryset.

0 comments on commit 7b85ef9

Please sign in to comment.