Ticket #15646: 15646.diff

docs/ref/models/fields.txt

@@ -572 +572 @@
 :class:`~django.core.files.File` class reference and the :doc:`/topics/files`
 topic guide.
 
+.. note::
+    The file is saved as part of saving the model in the database, so the actual
+    file name used on disk cannot be relied on until after the model has been
+    saved.
+
 The uploaded file's relative URL can be obtained using the
 :attr:`~django.db.models.fields.FileField.url` attribute. Internally,
 this calls the :meth:`~django.core.files.storage.Storage.url` method of the

docs/topics/files.txt

@@ -45 +45 @@
 This object -- ``car.photo`` in the example -- is a ``File`` object, which means
 it has all the methods and attributes described below.
 
+.. note::
+    The file is saved as part of saving the model in the database, so the actual
+    file name used on disk cannot be relied on until after the model has been
+    saved.
+
+
 The ``File`` object
 ===================