? file_save_upload_docs_d7.patch
Index: includes/file.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/file.inc,v
retrieving revision 1.156
diff -u -p -r1.156 file.inc
--- includes/file.inc	31 Jan 2009 16:50:56 -0000	1.156
+++ includes/file.inc	12 Feb 2009 20:46:23 -0000
@@ -847,6 +847,19 @@ function file_space_used($uid = NULL, $s
  * @return
  *   An object containing the file information if the upload succeeded, FALSE
  *   in the event of an error, or NULL if no file was uploaded.
+ *   The object will contain the following field members:
+ *   -filename - The name of the file that was uploaded.  This is not the file name 
+ *   <em>after</em> uploading and processing.
+ *   -filepath - The path to the file after it has been processed and uploaded.  This 
+ *   will contain the unique filename if a unique name was generated.
+ *   -filemime - The MIME file type.
+ *   -source - The name of the form item from which this file was uploaded.
+ *   -destination - The destination path that this file was uploaded to, including 
+ *   the file name and extension.
+ *   -size - The file size in bytes.
+ *   -uid - The user ID of the user who uploaded this file.
+ *   -status - The status of file.
+ *   -timestamp - A timestamp of time that this file was uploaded successfully.
  */
 function file_save_upload($source, $validators = array(), $destination = FALSE, $replace = FILE_EXISTS_RENAME) {
   global $user;