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
 -------------------------------------