Ticket #4214: db-api.patch

db-api.txt

@@ -134 +134 @@
-
-The ``save()`` method has no return value.
-
+How to update a Foreign Key field
+---------------------------------
+
+To update a foreign key field, assign a compatible database object to the field.
+
+Given a models.py contained this definition
+
+        class Blog(models.Model):
+                ...
+                owner = models.ForeignKey('Owner')
+
+This example would update ``Blog`` instance ``b5`` to point to "Jill" as the owner for the blog::
+
+        p = Owner.objects.create(name="Jill")
+        b5.owner = p
+        b5.save()
+
-How Django knows to UPDATE vs. INSERT
--------------------------------------
-