Ticket #7048: DeletableFileFields-00_docs.txt

Meta options
============

``files_add_delete_option``
---------------------------

This option is ``True`` by default.

When set to ``True``, all ``FileField``s get delete checkboxes if they have the
option ``blank=True``. The current file is also displayed above the field, regardless
of the value of ``blank``.

``files_delete_from_disk``
---------------------------

This option is ``True`` by default.

When set to ``True``, files of ``FileField`` are deleted from the disk. This happens
when a FileField is updated or when it is cleared. The latter is only possible if
``files_add_delete_option`` is ``True``.

``files_delete_empty_dirs``
---------------------------

This option is ``False`` by default.

When set to ``True``, Django removes *empty* directories after each file is deleted. It
starts with the directory of the file and then moves it's way up till it reaches the
``MEDIA_ROOT`` folder. **Warning**: This may delete more directories than you want.
Use with caution!

For example, if Django deletes the following file:

    /media-root/foo/bar/file.png
    
It will first try to delete ``/media-root/foo/bar/`` and then ``/media-root/foo/``.