diff --git a/includes/file.inc b/includes/file.inc
index f9c38b2..0d31b06 100644
--- a/includes/file.inc
+++ b/includes/file.inc
@@ -831,7 +831,9 @@ function file_save_data($data, $dest, $replace = FILE_EXISTS_RENAME) {
  * Set the status of a file.
  *
  * @param file A Drupal file object
- * @param status A status value to set the file to.
+ * @param status A status value to set the file to. One among the two defined
+ *   constants FILE_STATUS_PERMANENT and FILE_STATUS_TEMPORARY.
+ * 
  * @return FALSE on failure, TRUE on success and $file->status will contain the
  *     status.
  */