Index: modules/user/user.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/user/user.module,v
retrieving revision 1.1152
diff -u -p -r1.1152 user.module
--- modules/user/user.module	6 Apr 2010 19:49:03 -0000	1.1152
+++ modules/user/user.module	7 Apr 2010 12:08:42 -0000
@@ -187,6 +187,15 @@ function user_field_extra_fields() {
   return $return;
 }
 
+/**
+ * Fetches a user object based on an external authentication source.
+ *
+ * @param string $authname
+ *   The external authentication username.
+ *
+ * @return
+ *   A fully-loaded user object if the user is found or FALSE if not found.
+ */
 function user_external_load($authname) {
   $uid = db_query("SELECT uid FROM {authmap} WHERE authname = :authname", array(':authname' => $authname))->fetchField();