Ticket #1994: db-api.diff

db-api.txt

@@ -1563 +1563 @@
 where ``FOO`` is the name of the field. This returns the size of the file, in
 bytes. (Behind the scenes, it uses ``os.path.getsize``.)
 
-save_FOO_file(filename, raw_contents)
+save_FOO_file(filename, raw_contents, upload_to="")
 -------------------------------------
 
 For every ``FileField``, the object will have a ``save_FOO_file()`` method,
 where ``FOO`` is the name of the field. This saves the given file to the
 filesystem, using the given filename. If a file with the given filename already
 exists, Django adds an underscore to the end of the filename (but before the
-extension) until the filename is available.
+extension) until the filename is available. 
 
+The optional ``upload_to`` keyword allows you to override the ``upload_to`` that is specified in the model. Note that this override is per-save, so if you don't specify it the next time you call this method, the ``upload_to`` in the model will be used.
+
 get_FOO_height() and get_FOO_width()
 ------------------------------------