Kaydet (Commit) 1aa41dd0 authored tarafından Tim Graham's avatar Tim Graham

Fixed #23974 -- Clarified wording of FileField.save/delete save parameter.

Thanks GreenAsJade.
üst 4d27d72d
...@@ -715,8 +715,9 @@ method is used to persist that file data. ...@@ -715,8 +715,9 @@ method is used to persist that file data.
Takes two required arguments: ``name`` which is the name of the file, and Takes two required arguments: ``name`` which is the name of the file, and
``content`` which is an object containing the file's contents. The ``content`` which is an object containing the file's contents. The
optional ``save`` argument controls whether or not the instance is optional ``save`` argument controls whether or not the model instance is
saved after the file has been altered. Defaults to ``True``. saved after the file associated with this field has been altered. Defaults to
``True``.
Note that the ``content`` argument should be an instance of Note that the ``content`` argument should be an instance of
:class:`django.core.files.File`, not Python's built-in file object. :class:`django.core.files.File`, not Python's built-in file object.
...@@ -741,8 +742,9 @@ Deletes the file associated with this instance and clears all attributes on ...@@ -741,8 +742,9 @@ Deletes the file associated with this instance and clears all attributes on
the field. Note: This method will close the file if it happens to be open when the field. Note: This method will close the file if it happens to be open when
``delete()`` is called. ``delete()`` is called.
The optional ``save`` argument controls whether or not the instance is saved The optional ``save`` argument controls whether or not the model instance is
after the file has been deleted. Defaults to ``True``. saved after the file associated with this field has been deleted. Defaults to
``True``.
Note that when a model is deleted, related files are not deleted. If you need Note that when a model is deleted, related files are not deleted. If you need
to cleanup orphaned files, you'll need to handle it yourself (for instance, to cleanup orphaned files, you'll need to handle it yourself (for instance,
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment