Ticket #8641: r8729.diff

docs/ref/files/file.txt

@@ -100 +100 @@
 
 Saves a new file with the file name and contents provided. This will not replace
 the existing file, but will create a new file and update the object to point to
-it. If ``save`` is ``True``, the model's ``save()`` method will be called once
+it. The ``content`` parameter must be another :class:`File` object.  A file on
+the server can be saved by::
+
+    >>> photo = open('/path/to/myphoto.jpg')
+    >>> car.photo.save('myphoto.jpg', File(photo), True)
+
+If ``save`` is ``True``, the model's ``save()`` method will be called once
 the file is saved. That is, these two lines::
 
     >>> car.photo.save('myphoto.jpg', contents, save=False)