File upload documentation should emphasize the need to add multipart/form-data

[Claude Paroz]

Even if it is explained in the request-response documentation (​http://docs.djangoproject.com/en/dev/ref/request-response/#django.http.HttpRequest.FILES), I suggest to repeat the need to add multipart/form-data to the form tag in the 'File Upload' documentation. Following a patch which simply repeat the request-reponse note about it in the topics/http/file-uploads.txt doc file.

[Tim Graham]

slightly modified from original patch

[Tim Graham]

added metadata targets

[Karen Tracey]

(In [10816]) Fixed #10400: Added a note in the file uploads doc about the correct form type needed for file uploads to work. Thanks claudep and timo.

[Karen Tracey]

(In [10817]) [1.0.X] Fixed #10400: Added a note in the file uploads doc about the correct form type needed for file uploads to work. Thanks claudep and timo.

r10816 from trunk.

[Karen Tracey]

Note I didn't used the metadata target version of the patch because it seems to reference model fields, yet this doc is strictly about forms, so shouldn't the pointers reference form fields? Feel free to open another ticket to get the references in, but either point them to form fields or explain why they should go to ~django.db.models.FileField, e.g. ... that doesn't look right to me when the code examples are just using form fields.