Issue #2311219 by Mile23, a_thakur, vadim.hirbu, undertext, xjm, cilefen,...

Issue #2311219 by Mile23, a_thakur, vadim.hirbu, undertext, xjm, cilefen, damiankloip, daffie: Remove references to function user_format_name() from documentation

core/modules/user/user.api.php

@@ -107,15 +107,15 @@ function hook_user_cancel_methods_alter(&$methods) {
  *
  * Called by $account->getDisplayName() to allow modules to alter the username
  * that is displayed. Can be used to ensure user privacy in situations where
- * $account->name is too revealing.
+ * $account->getDisplayName() is too revealing.
  *
  * @param string $name
  *   The string that $account->getDisplayName() will return.
  *
  * @param $account
- *   The account object passed to user_format_name().
+ *   The account object the name belongs to.
  *
- * @see $account->getDisplayName()
+ * @see \Drupal\Core\Session\AccountInterface->getDisplayName()
  */
 function hook_user_format_name_alter(&$name, $account) {
   // Display the user's uid instead of name.