diff --git a/core/modules/user/user.module b/core/modules/user/user.module
index e90c907..82e19c9 100644
--- a/core/modules/user/user.module
+++ b/core/modules/user/user.module
@@ -1816,7 +1816,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.
+ *   An object containing the user account, 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.
  * @param array $options
  *   (optional) A keyed array of settings. Supported options are:
  *   - langcode: A language code to be used when generating locale-sensitive
@@ -1846,7 +1850,7 @@ function user_pass_reset_url($account, $options = array()) {
  *   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.
  * @param array $options
  *   (optional) A keyed array of settings. Supported options are:
  *   - langcode: A language code to be used when generating locale-sensitive
@@ -1882,12 +1886,12 @@ function user_cancel_url($account, $options = array()) {
  * 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
- *   A unix timestamp.
- * @param $login
- *   The user account login name.
+ * @param int $timestamp
+ *   A UNIX timestamp.
+ * @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.