Ticket #8641: 8641.file-doc.diff

django/django/docs/topics/files.txt

@@ -96 +96 @@
 useful -- you can use the global default storage system::
 
     >>> from django.core.files.storage import default_storage
+    >>> from django.core.files.base import ContentFile
 
-    >>> path = default_storage.save('/path/to/file', 'new content')
+    >>> path = default_storage.save('/path/to/file', ContentFile('new content'))
     >>> path
     u'/path/to/file'
 

django/django/docs/ref/files/storage.txt

@@ -41 +41 @@
 If there already exists a file with this name ``name``, the storage system may
 modify the filename as necessary to get a unique name. The actual name of the
 stored file will be returned.
+Also, the given ``content`` has to be a :ref:`Django File <ref-files-file>`
+object. If you need to save another type of object -- a string for example --
+you'll need to first wrap it into a Django File object.
 
 ``Storage.delete(name)``
 ~~~~~~~~~~~~~~~~~~~~~~~~