diff --git a/core/includes/file.inc b/core/includes/file.inc
index 18c28208f569097a8f5566c82b3a227bb5d90e1d..1028f5e9b6b73d6f40b92fa1b1c3ebe17da1580b 100644
--- a/core/includes/file.inc
+++ b/core/includes/file.inc
@@ -1171,7 +1171,11 @@ function file_unmanaged_save_data($data, $destination = NULL, $replace = FILE_EX
  *
  * Directories and files beginning with a dot are excluded; this prevents
  * hidden files and directories (such as SVN working directories) from being
- * scanned.
+ * scanned. Use the umask option to skip configuration directories to
+ * eliminate the possibility of accidentally exposing configuration
+ * information. Also, you can use the base directory, recurse, and min_depth
+ * options to improve performance by limiting how much of the filesystem has
+ * to be traversed.
  *
  * @param $dir
  *   The base directory or URI to scan, without trailing slash.