Ticket #11022: 11022-bulk-delete-warning-r10680.diff

docs/ref/contrib/admin/actions.txt

@@ -23 +23 @@
 :mod:`django.contrib.auth` app:
 
 .. image:: _images/user_actions.png
+
+.. warning::
+
+    The "delete selected objects" action uses ``QuerySet.delete()`` for
+    efficiency reasons, which has some important side-effects. Notably,
+    your model's ``delete()`` method will not be called in the interests of
+    efficiency.
     
+    If you wish to override this behavior, simply write a custom action which
+    accomplishes deletion in your preferred manner -- for example, by calling
+    ``Model.delete()`` for each of the selected items.
+    
+    For more background on queryset bulk deletion, see the documentation for 
+    :ref:`queryset object deletion <topics-db-queries-delete>`.
+
 Read on to find out how to add your own actions to this list.
 
 Writing actions