From 322a6a9d1dffee284bb9ea1b309e64f7fa7411b5 Mon Sep 17 00:00:00 2001 From: Russell Keith-Magee Date: Thu, 19 Feb 2009 22:45:48 +0000 Subject: [PATCH] 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 --- docs/topics/db/queries.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/topics/db/queries.txt b/docs/topics/db/queries.txt index c54039efa04..b58d955a74e 100644 --- a/docs/topics/db/queries.txt +++ b/docs/topics/db/queries.txt @@ -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 ` 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