Author: gabrielhurley Date: 2010-12-28 17:24:34 -0600 (Tue, 28 Dec 2010) New Revision: 15088
Modified: django/trunk/docs/ref/models/fields.txt Log: Fixed #14905 -- Corrected some misleading linking and language in the FileField docs. Thanks to Keryn Knight for the report and draft patch. Modified: django/trunk/docs/ref/models/fields.txt =================================================================== --- django/trunk/docs/ref/models/fields.txt 2010-12-28 22:54:32 UTC (rev 15087) +++ django/trunk/docs/ref/models/fields.txt 2010-12-28 23:24:34 UTC (rev 15088) @@ -546,11 +546,18 @@ day. If you upload a file on Jan. 15, 2007, it will be saved in the directory ``/home/media/photos/2007/01/15``. -If you want to retrieve the upload file's on-disk filename, or a URL that refers -to that file, or the file's size, you can use the -:attr:`~django.core.files.File.name`, :attr:`~django.core.files.File.url` -and :attr:`~django.core.files.File.size` attributes; see :doc:`/topics/files`. +If you wanted to retrieve the uploaded file's on-disk filename, or the file's +size, you could use the :attr:`~django.core.files.File.name` and +:attr:`~django.core.files.File.size` attributes respectively; for more +information on the available attributes and methods, see the +:class:`~django.core.files.File` class reference and the :doc:`/topics/files` +topic guide. +The uploaded file's relative URL can be obtained using the +:attr:`~django.db.models.fields.FileField.url` attribute. Internally, +this calls the :meth:`~django.core.files.storage.Storage.url` method of the +underlying :class:`~django.core.files.storage.Storage` class. + Note that whenever you deal with uploaded files, you should pay close attention to where you're uploading them and what type of files they are, to avoid security holes. *Validate all uploaded files* so that you're sure the files are -- You received this message because you are subscribed to the Google Groups "Django updates" group. To post to this group, send email to django-upda...@googlegroups.com. To unsubscribe from this group, send email to django-updates+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/django-updates?hl=en.