Ticket #32045: 32045.diff

docs/ref/contrib/contenttypes.txt

@@ -443 +443 @@
 behavior can be provided via the :data:`~django.db.models.signals.pre_delete`
 signal.
 
+Methods on ``GenericRelation`` managers
+---------------------------------------
+
+    .. method:: remove(*objs, bulk=True)
+
+        Removes the specified model objects from the related object set and
+        deletes them from the database.
+
+    .. code-block:: python
+
+        >>> b.tags.remove(t) # Deletes TaggedItem t from database.
+
+    .. method:: clear()
+
+        Removes all items from the related object set and deletes them from the 
+        database.
+
+    .. code-block:: python
+
+        >>> b.tags.clear() # Deletes all related TaggedItems from database.
+
+In both the above examples this behaviour differs from that of 
+:class:`django.db.models.fields.related.RelatedManager` which has
+methods named ``remove`` and ``clear`` which disassociate the 
+related objects without deleting them from the database.
+
 Generic relations and aggregation
 ---------------------------------