Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Fixed #3857 -- Used a table to describe the required arg for FileFiel…

…d. This

makes it consistent with other argument descriptions. Thanks, whiteinge.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 56b8914 commit 939f678e6542949e3befd83437d58860b9abac34 @malcolmt malcolmt committed
Showing with 16 additions and 7 deletions.
  1. +16 −7 docs/model-api.txt
23 docs/model-api.txt
@@ -194,14 +194,23 @@ This doesn't accept ``maxlength``; its ``maxlength`` is automatically set to
-A file-upload field.
+A file-upload field. Has one **required** argument:
-Has an extra required argument, ``upload_to``, a local filesystem path to
-which files should be upload. This path may contain `strftime formatting`_,
-which will be replaced by the date/time of the file upload (so that
-uploaded files don't fill up the given directory).
+ ====================== ===================================================
+ Argument Description
+ ====================== ===================================================
+ ``upload_to`` A local filesystem path that will be appended to
+ your ``MEDIA_ROOT`` setting to determine the
+ output of the ``get_<fieldname>_url()`` helper
+ function.
+ ====================== ===================================================
+This path may contain `strftime formatting`_, which will be replaced by the
+date/time of the file upload (so that uploaded files don't fill up the given
-The admin represents this as an ``<input type="file">`` (a file-upload widget).
+The admin represents this field as an ``<input type="file">`` (a file-upload
Using a ``FileField`` or an ``ImageField`` (see below) in a model takes a few
@@ -246,7 +255,7 @@ visiting its URL on your site. Don't allow that.
A field whose choices are limited to the filenames in a certain directory
on the filesystem. Has three special arguments, of which the first is
====================== ===================================================
Argument Description

0 comments on commit 939f678

Please sign in to comment.
Something went wrong with that request. Please try again.