`` that posted to the request had
``enctype="multipart/form-data"``. Otherwise, ``FILES`` will be a blank
Index: docs/settings.txt
===================================================================
--- docs/settings.txt (revision 5070)
+++ docs/settings.txt (working copy)
@@ -437,6 +437,24 @@
.. _Testing Django Applications: ../testing/
+FILE_UPLOAD_DIR
+---------------
+
+Default: Not defined
+
+Path to a directory where temporary files should be written during
+file uploads. Leaving this unset will read files into memory.
+
+FILE_UPLOAD_MIN_SIZE
+--------------------
+
+Default: 100000
+
+An integer specifying the minimum number of bytes that has to be
+received for file upload streaming to take place. Any request smaller
+than this will be handled in memory. Note: ``FILE_UPLOAD_DIR`` has to
+be defined to enable streaming.
+
IGNORABLE_404_ENDS
------------------
Index: docs/forms.txt
===================================================================
--- docs/forms.txt (revision 5070)
+++ docs/forms.txt (working copy)
@@ -475,6 +475,19 @@
new_data = request.POST.copy()
new_data.update(request.FILES)
+Streaming file uploads.
+-----------------------
+
+File uploads will be read into memory by default. This works fine for
+small to medium sized uploads (from 1MB to 100MB depending on your
+setup and usage). If you want to support larger uploads you can enable
+upload streaming where only a small part of the file will be in memory
+at any time. To do this you need to specify the ``FILE_UPLOAD_DIR``
+setting (see the settings_ document for more details).
+
+See `request object`_ for more details about ``request.FILES`` objects
+with streaming file uploads enabled.
+
Validators
==========
@@ -689,6 +702,7 @@
At validation time, the XML fragment is validated against the schema using
the executable specified in the ``JING_PATH`` setting (see the settings_
document for more details).
+.. _request object: ../request_response/#httprequest-objects
.. _`generic views`: ../generic_views/
.. _`models API`: ../model-api/