diff --git a/core/modules/user/user.module b/core/modules/user/user.module
index 1e7aa99..992b29b 100644
--- a/core/modules/user/user.module
+++ b/core/modules/user/user.module
@@ -2111,7 +2111,11 @@ function user_external_login_register($name, $module) {
  * Generates a unique URL for a user to login and reset their password.
  *
  * @param object $account
- *   An object containing the user account.
+ *   The user account object, which must contain at least the following
+ *   properties:
+ *   - uid: The user uid number.
+ *   - pass: The hashed user password string.
+ *   - login: A unix timestamp of the user's last login.
  *
  * @return
  *   A unique URL that provides a one-time log in for the user, from which
@@ -2130,7 +2134,7 @@ function user_pass_reset_url($account) {
  *   properties:
  *   - uid: The user uid number.
  *   - pass: The hashed user password string.
- *   - login: The user login name.
+ *   - login: A unix timestamp of the user's last login.
  *
  * @return
  *   A unique URL that may be used to confirm the cancellation of the user
@@ -2155,12 +2159,12 @@ function user_cancel_url($account) {
  * name and hashed password are retrieved from the database as necessary. For a
  * usage example, see user_cancel_url() and user_cancel_confirm().
  *
- * @param $password
+ * @param string $password
  *   The hashed user account password value.
- * @param $timestamp
+ * @param int $timestamp
  *   A unix timestamp.
- * @param $login
- *   The user account login name.
+ * @param int $login
+ *   A unix timestamp of the user's last login..
  *
  * @return
  *   A string that is safe for use in URLs and SQL statements.