? file_save_upload_docs_d6.patch
Index: includes/file.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/file.inc,v
retrieving revision 1.121.2.5
diff -u -p -r1.121.2.5 file.inc
--- includes/file.inc	20 Oct 2008 09:42:31 -0000	1.121.2.5
+++ includes/file.inc	12 Feb 2009 20:42:03 -0000
@@ -476,6 +476,19 @@ function file_space_used($uid = NULL) {
  *   new, unique filename in the destination directory.
  * @return
  *   An object containing the file information, or 0 in the event of an error.
+ *   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(), $dest = FALSE, $replace = FILE_EXISTS_RENAME) {
   global $user;