Index: modules/file/file.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/file/file.module,v
retrieving revision 1.48
diff -u -p -r1.48 file.module
--- modules/file/file.module	11 Dec 2010 01:32:20 -0000	1.48
+++ modules/file/file.module	11 Dec 2010 21:54:21 -0000
@@ -944,6 +944,8 @@ function file_icon_map($file) {

 /**
  * Gets a list of references to a file.
+ *
+ * File references are a way for entities to declare usage of a file.
  *
  * @param $file
  *   A file object.
@@ -959,7 +961,7 @@ function file_icon_map($file) {
  *   to fields of the given type.
  *
  * @return
- *   An integer value.
+ *   An array of references.
  */
 function file_get_file_references($file, $field = NULL, $age = FIELD_LOAD_REVISION, $field_type = 'file') {
   $references = drupal_static(__FUNCTION__, array());