Commit 322a6a9d authored by Russell Keith-Magee's avatar Russell Keith-Magee
Browse files

Fixed #10303 -- Corrected a contradiction in the docs regarding the... 

Fixed #10303 -- Corrected a contradiction in the docs regarding the capabilities of the .update() clause that was introduced by the documentation for F() expressions. Thanks to gluckj for the report.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@9846 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent fc02370c

docs/topics/db/queries.txt

+3 −3
Original line number Diff line number Diff line
@@ -767,9 +767,7 @@ a ``QuerySet``. You can do this with the ``update()`` method. For example:: 
    Entry.objects.filter(pub_date__year=2007).update(headline='Everything is the same')



You can only set non-relation fields and ``ForeignKey`` fields using this

method, and the value you set the field to must be a hard-coded Python value

(i.e., you can't set a field to be equal to some other field at the moment).



method. To update a non-relation field, provide the new value as a constant.

To update ``ForeignKey`` fields, set the new value to be the new model

instance you want to point to. Example::
@@ -795,6 +793,8 @@ Just loop over them and call ``save()``:: 
    for item in my_queryset:

        item.save()



.. versionadded:: 1.1



Calls to update can also use :ref:`F() objects <query-expressions>` to update

one field based on the value of another field in the model. This is especially

useful for incrementing counters based upon their current value. For example, to