diff --git a/core/modules/user/user.module b/core/modules/user/user.module
index ef0768497c9e57479a2628ac4f3cbe28e176505b..74ce5de07c797064d65b489e14c3d4b824c10f4d 100644
--- a/core/modules/user/user.module
+++ b/core/modules/user/user.module
@@ -258,9 +258,9 @@ function user_load($uid, $reset = FALSE) {
  *
  * @param string $mail
  *   String with the account's email address.
- * @return object|bool
- *   A fully-loaded $user object upon successful user load or FALSE if user
- *   cannot be loaded.
+ *
+ * @return \Drupal\user\UserInterface|false
+ *   A user entity upon successful user load, or FALSE if user cannot be loaded.
  *
  * @see \Drupal\user\Entity\User::loadMultiple()
  */
@@ -275,9 +275,9 @@ function user_load_by_mail($mail) {
  *
  * @param string $name
  *   String with the account's user name.
- * @return object|bool
- *   A fully-loaded $user object upon successful user load or FALSE if user
- *   cannot be loaded.
+ *
+ * @return \Drupal\user\UserInterface|false
+ *   A user entity upon successful user load, or FALSE if user cannot be loaded.
  *
  * @see \Drupal\user\Entity\User::loadMultiple()
  */