Index: db-api.txt
===================================================================
--- db-api.txt	(revision 5148)
+++ db-api.txt	(working copy)
@@ -134,6 +134,23 @@
 
 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
 -------------------------------------