Browse Source

Fixed #22347 -- Unified FileSystemStorage documentation.

Thanks nliberg for the report.
Vishal Lal 11 years ago
parent
commit
ca93f02c62
2 changed files with 12 additions and 14 deletions
  1. 10 0
      docs/ref/files/storage.txt
  2. 2 14
      docs/topics/files.txt

+ 10 - 0
docs/ref/files/storage.txt

@@ -36,6 +36,16 @@ The FileSystemStorage Class
     :class:`~django.core.files.storage.Storage` and provides implementations
     for all the public methods thereof.
 
+    .. attribute:: location
+
+	Absolute path to the directory that will hold the files.
+        Defaults to the value of your :setting:`MEDIA_ROOT` setting.
+
+    .. attribute:: base_url
+
+	URL that serves the files stored at this location.
+	Defaults to the value of your :setting:`MEDIA_URL` setting.
+
     .. attribute:: file_permissions_mode
 
         The file system permissions that the file will receive when it is

+ 2 - 14
docs/topics/files.txt

@@ -149,20 +149,8 @@ See :doc:`/ref/files/storage` for the file storage API.
 The built-in filesystem storage class
 -------------------------------------
 
-Django ships with a built-in ``FileSystemStorage`` class (defined in
-``django.core.files.storage``) which implements basic local filesystem file
-storage. Its initializer takes two arguments:
-
-======================  ===================================================
-Argument                Description
-======================  ===================================================
-``location``            Optional. Absolute path to the directory that will
-                        hold the files. If omitted, it will be set to the
-                        value of your :setting:`MEDIA_ROOT` setting.
-``base_url``            Optional. URL that serves the files stored at this
-                        location. If omitted, it will default to the value
-                        of your :setting:`MEDIA_URL` setting.
-======================  ===================================================
+Django ships with a :class:`django.core.files.storage.FileSystemStorage` class
+which implements basic local filesystem file storage.
 
 For example, the following code will store uploaded files under
 ``/media/photos`` regardless of what your :setting:`MEDIA_ROOT` setting is::