Index: modules/user/user.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/user/user.module,v
retrieving revision 1.892.2.12
diff -u -r1.892.2.12 user.module
--- modules/user/user.module	25 Feb 2009 13:57:04 -0000	1.892.2.12
+++ modules/user/user.module	7 Mar 2009 20:54:24 -0000
@@ -193,13 +193,14 @@
  * Save changes to a user account or add a new user.
  *
  * @param $account
- *   The $user object for the user to modify or add. If $user->uid is
- *   omitted, a new user will be added.
+ *   (optional) The $user object to modify or add. If $account is an object
+ *   and $account->uid is non-empty, that user account will be modified.
+ *   Otherwise, a new user will be added.
  *
  * @param $array
  *   (optional) An array of fields and values to save. For example,
  *   array('name' => 'My name'); Setting a field to NULL deletes it from
- *   the data column.
+ *   the data column, if you are modifying an existing user.
  *
  * @param $category
  *   (optional) The category for storing profile information in.