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
This commit is contained in:
Russell Keith-Magee 2009-02-19 22:45:48 +00:00
parent fc02370cee
commit 322a6a9d1d
1 changed files with 3 additions and 3 deletions

View File

@ -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') 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 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 method. To update a non-relation field, provide the new value as a constant.
(i.e., you can't set a field to be equal to some other field at the moment).
To update ``ForeignKey`` fields, set the new value to be the new model To update ``ForeignKey`` fields, set the new value to be the new model
instance you want to point to. Example:: instance you want to point to. Example::
@ -795,6 +793,8 @@ Just loop over them and call ``save()``::
for item in my_queryset: for item in my_queryset:
item.save() item.save()
.. versionadded:: 1.1
Calls to update can also use :ref:`F() objects <query-expressions>` to update 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 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 useful for incrementing counters based upon their current value. For example, to