summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorTim Graham <timograham@gmail.com>2014-08-23 09:30:01 -0400
committerTim Graham <timograham@gmail.com>2014-08-23 09:30:01 -0400
commitc7fa27d702fc3988feae57f663779b31bfe8f340 (patch)
treeefad78523e257a6bc0fed10a8c21df17d90b45f8 /docs/ref
parent2c681e8a8c453b1691219eace7ed5dc636e37948 (diff)
Fixed #23344 -- Removed duplicate docs for file upload settings.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/settings.txt19
1 files changed, 14 insertions, 5 deletions
diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt
index 913f49f47c..e2b2f2d9c7 100644
--- a/docs/ref/settings.txt
+++ b/docs/ref/settings.txt
@@ -1243,7 +1243,10 @@ Default::
("django.core.files.uploadhandler.MemoryFileUploadHandler",
"django.core.files.uploadhandler.TemporaryFileUploadHandler")
-A tuple of handlers to use for uploading. See :doc:`/topics/files` for details.
+A tuple of handlers to use for uploading. Changing this setting allows complete
+customization -- even replacement -- of Django's upload process.
+
+See :doc:`/topics/files` for details.
.. setting:: FILE_UPLOAD_MAX_MEMORY_SIZE
@@ -1290,6 +1293,9 @@ dependent behavior. On most platforms, temporary files will have a mode
of ``0o600``, and files saved from memory will be saved using the
system's standard umask.
+For security reasons, these permissions aren't applied to the temporary files
+that are stored in :setting:`FILE_UPLOAD_TEMP_DIR`.
+
This setting also determines the default permissions for collected static files
when using the :djadmin:`collectstatic` management command. See
:djadmin:`collectstatic` for details on overriding it.
@@ -1303,7 +1309,6 @@ when using the :djadmin:`collectstatic` management command. See
way that modes must be specified. If you try to use ``644``, you'll
get totally incorrect behavior.
-
.. setting:: FILE_UPLOAD_TEMP_DIR
FILE_UPLOAD_TEMP_DIR
@@ -1311,9 +1316,11 @@ FILE_UPLOAD_TEMP_DIR
Default: ``None``
-The directory to store data temporarily while uploading files. If ``None``,
-Django will use the standard temporary directory for the operating system. For
-example, this will default to '/tmp' on \*nix-style operating systems.
+The directory to store data (typically files larger than
+:setting:`FILE_UPLOAD_MAX_MEMORY_SIZE`) temporarily while uploading files.
+If ``None``, Django will use the standard temporary directory for the operating
+system. For example, this will default to ``/tmp`` on \*nix-style operating
+systems.
See :doc:`/topics/files` for details.
@@ -2926,6 +2933,8 @@ Error reporting
* :setting:`MANAGERS`
* :setting:`SILENCED_SYSTEM_CHECKS`
+.. _file-upload-settings:
+
File uploads
------------
* :setting:`DEFAULT_FILE_STORAGE`