Ticket #15588: filefield_doc.diff

docs/releases/1.3.txt

@@ -359 +359 @@
 mechanism mentioned above. This is backwards-incompatible for any
 users relying on the prior ability to insert arbitrary lookups.
 
-FileField no longer deletes files
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Deleting a model doesn't delete associated files
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In earlier Django versions, when a model instance containing a
 :class:`~django.db.models.FileField` was deleted,
 :class:`~django.db.models.FileField` took it upon itself to also delete the
 file from the backend storage. This opened the door to several data-loss
 scenarios, including rolled-back transactions and fields on different models
-referencing the same file. In Django 1.3, :class:`~django.db.models.FileField`
-will never delete files from the backend storage. If you need cleanup of
-orphaned files, you'll need to handle it yourself (for instance, with a custom
-management command that can be run manually or scheduled to run periodically
-via e.g. cron).
+referencing the same file. In Django 1.3, when a model is deleted the
+:class:`~django.db.models.FileField`'s
+:func:`~django.db.models.FileField.delete` method won't be called.  If you
+need cleanup of orphaned files, you'll need to handle it yourself (for
+instance, with a custom management command that can be run manually or
+scheduled to run periodically via e.g. cron).
 
 PasswordInput default rendering behavior
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~