Changeset 7884

Timestamp:

07/11/08 05:03:04 (2 months ago)

Author:

mtredinnick

Message:

Documented that the update() method on querysets is a direct SQL call, not the
same as looping over the queryset and calling save() on each item (which is
less efficient). Fixed #7447.

Files:

• django/trunk/docs/db-api.txt (modified) (1 diff)

django/trunk/docs/db-api.txt

@@ -2213 +2213 @@
-it won't work.
-
+Be aware that the ``update()`` method is converted directly to an SQL
+statement. It is a bulk operation for direct updates. It doesn't run any
+``save()`` methods on your models, or emit the ``pre_save`` or ``post_save``
+signals (which are a consequence of calling ``save()``). If you want to save
+every item in a ``QuerySet`` and make sure that the ``save()`` method is
+called on each instance, you don't need any special function to handle that.
+Just loop over them and call ``save()``:
+
+    for item in my_queryset:
+        item.save()
+
+
-Extra instance methods
-======================