From eb0da7e135b938dac330567693be549866119095 Mon Sep 17 00:00:00 2001
From: Bob Vincent <bobvin@pillars.net>
Date: Fri, 17 Jun 2011 13:44:25 -0400
Subject: [PATCH] Issue #1991236: Correct documentation of file_copy, file_move, drupal_realpath, file_unmanaged_save_data, and file_save_data to match the implemented functionality.

---
 includes/file.inc |   15 ++++++---------
 1 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/includes/file.inc b/includes/file.inc
index 4750ff481fe297ea9581782b1f71ba9207d8043c..8eba2ef4c4c203ffa99ac2f81dd77a9c177c0b2c 100644
--- a/includes/file.inc
+++ b/includes/file.inc
@@ -737,8 +737,7 @@ function file_usage_delete(stdClass $file, $module, $type = NULL, $id = NULL, $c
  *   A file object.
  * @param $destination
  *   A string containing the destination that $source should be copied to.
- *   This must be a stream wrapper URI. If this value is omitted, Drupal's
- *   default files scheme will be used, usually "public://".
+ *   This must be a stream wrapper URI.
  * @param $replace
  *   Replace behavior when the destination file already exists:
  *   - FILE_EXISTS_REPLACE - Replace the existing file. If a managed file with
@@ -967,8 +966,7 @@ function file_destination($destination, $replace) {
  *   A file object.
  * @param $destination
  *   A string containing the destination that $source should be moved to.
- *   This must be a stream wrapper URI. If this value is omitted, Drupal's
- *   default files scheme will be used, usually "public://".
+ *   This must be a stream wrapper URI.
  * @param $replace
  *   Replace behavior when the destination file already exists:
  *   - FILE_EXISTS_REPLACE - Replace the existing file. If a managed file with
@@ -1756,8 +1754,8 @@ function file_validate_image_resolution(stdClass $file, $maximum_dimensions = 0,
  *   A string containing the contents of the file.
  * @param $destination
  *   A string containing the destination URI.
- *   This must be a stream wrapper URI. If this value is omitted, Drupal's
- *   default files scheme will be used, usually "public://".
+ *   This must be a stream wrapper URI. If this value is omitted or empty,
+ *   Drupal's default files scheme will be used, usually "public://".
  * @param $replace
  *   Replace behavior when the destination file already exists:
  *   - FILE_EXISTS_REPLACE - Replace the existing file. If a managed file with
@@ -1825,7 +1823,7 @@ function file_save_data($data, $destination = NULL, $replace = FILE_EXISTS_RENAM
  * @param $destination
  *   A string containing the destination location.
  *   This must be a stream wrapper URI.  If no value is provided, a
- *   randomized name will be generated and the file is saved using Drupal's
+ *   randomized name will be generated and the file saved using Drupal's
  *   default files scheme, usually "public://".
  * @param $replace
  *   Replace behavior when the destination file already exists:
@@ -2153,8 +2151,7 @@ function drupal_unlink($uri, $context = NULL) {
  * @see http://drupal.org/node/515192
  *
  * @param $uri
- *   A string containing the URI to verify. If this value is omitted,
- *   Drupal's public files directory will be used [public://].
+ *   A string containing the URI to verify.
  *
  * @return
  *   The absolute pathname, or FALSE on failure.
-- 
1.7.4.1