summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2014-12-08 13:15:46 -0500
committerTim Graham <timograham@gmail.com>2014-12-08 13:18:23 -0500
commit6022da4f48a1c3fd019aac52b3fe9b804b1746f9 (patch)
tree5e8b5c97e0029ac34b8079c7208623c667508fde /docs/ref
parent4862eb6e5b6dae63e5c156fa1095c5b87503620b (diff)
[1.7.x] Fixed #23974 -- Clarified wording of FileField.save/delete save parameter.
Thanks GreenAsJade. Backport of 1aa41dd000e0779c8b1de1f8e7aa4a0f2f752655 from master
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/models/fields.txt10
1 files changed, 6 insertions, 4 deletions
diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt
index 5707e448c2..ffef3029f2 100644
--- a/docs/ref/models/fields.txt
+++ b/docs/ref/models/fields.txt
@@ -719,8 +719,9 @@ method is used to persist that file data.
Takes two required arguments: ``name`` which is the name of the file, and
``content`` which is an object containing the file's contents. The
-optional ``save`` argument controls whether or not the instance is
-saved after the file has been altered. Defaults to ``True``.
+optional ``save`` argument controls whether or not the model instance is
+saved after the file associated with this field has been altered. Defaults to
+``True``.
Note that the ``content`` argument should be an instance of
:class:`django.core.files.File`, not Python's built-in file object.
@@ -745,8 +746,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
``delete()`` is called.
-The optional ``save`` argument controls whether or not the instance is saved
-after the file has been deleted. Defaults to ``True``.
+The optional ``save`` argument controls whether or not the model instance is
+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
to cleanup orphaned files, you'll need to handle it yourself (for instance,