comparison core/lib/Drupal/Core/Session/AccountInterface.php @ 17:129ea1e6d783

Update, including to Drupal core 8.6.10

    * @param bool $fallback_to_default
    *   (optional) Whether the return value will fall back to the site default
    *   language if the user has no language preference.
    *
    * @return string
-   *   The language code that is preferred by the account. If the preferred
-   *   language is not set or is a language not configured anymore on the site,
-   *   the site default is returned or an empty string is returned (if
-   *   $fallback_to_default is FALSE).
+   *   Returned language code depends upon following:
+   *   - The user preferred language code is returned if set in the account.
+   *   - If the user has no preferred language and $fallback_to_default is TRUE
+   *     then the site default language code is returned.
+   *   - If the user has no preferred language and $fallback_to_default is FALSE
+   *     then empty string is returned.
    */
   public function getPreferredLangcode($fallback_to_default = TRUE);
 
   /**
    * Returns the preferred administrative language code of the account.

    *   \Drupal\Core\Session\AccountInterface::getDisplayName() instead.
    *
    * @deprecated in Drupal 8.0.0, will be removed before Drupal 9.0.0.
    *   Use \Drupal\Core\Session\AccountInterface::getAccountName() or
    *   \Drupal\user\UserInterface::getDisplayName() instead.
+   *
+   * @see https://www.drupal.org/node/2572493
    */
   public function getUsername();
 
   /**
    * Returns the unaltered login name of this account.