Ticket #5068: 5068.patch

docs/db-api.txt

@@ -207 +207 @@
 
 The ``save()`` method has no return value.
 
-Updating ``ForeignKey`` fields works exactly the same way; simply assign an
-object of the right type to the field in question::
+Updating a ``ManyToManyField`` works a little different; use the ``add()``
+method on the field to add a record to the relation::
 
     joe = Author.objects.create(name="Joe")
-    entry.author = joe
-    entry.save()
+    entry.authors.add(joe)
 
-Django will complain if you try to assign an object of the wrong type.
+Django will complain if you try to add an object of the wrong type.
 
 How Django knows to UPDATE vs. INSERT
 -------------------------------------