Merge branch '5.2' into 5.x

* 5.2:
  [Validator] Fix return types
  Add translation for Belarusian
  fix parsing calls of methods named "method"
  [Security] Remove unnecessary inherited doc annotation
  deal with indented heredoc/nowdoc tokens
  Adding templates for Belarusian

Author: fabpot

Resources/translations/security.be.xlf

@@ -62,6 +62,14 @@
                 <source>Account is locked.</source>
                 <target>Акаўнт заблакіраван.</target>
             </trans-unit>
+            <trans-unit id="17">
+                <source>Too many failed login attempts, please try again later.</source>
+                <target>Зашмат няўдалых спроб уваходу, калі ласка, паспрабуйце пазней.</target>
+            </trans-unit>
+            <trans-unit id="18">
+                <source>Invalid or expired login link.</source>
+                <target>Спасылка для ўваходу несапраўдная або пратэрмінаваная.</target>
+            </trans-unit>
         </body>
     </file>
 </xliff>

User/User.php

@@ -83,31 +83,59 @@ public function getUsername(): string
     }
 
     /**
-     * {@inheritdoc}
+     * Checks whether the user's account has expired.
+     *
+     * Internally, if this method returns false, the authentication system
+     * will throw an AccountExpiredException and prevent login.
+     *
+     * @return bool true if the user's account is non expired, false otherwise
+     *
+     * @see AccountExpiredException
      */
     public function isAccountNonExpired(): bool
     {
         return $this->accountNonExpired;
     }
 
     /**
-     * {@inheritdoc}
+     * Checks whether the user is locked.
+     *
+     * Internally, if this method returns false, the authentication system
+     * will throw a LockedException and prevent login.
+     *
+     * @return bool true if the user is not locked, false otherwise
+     *
+     * @see LockedException
      */
     public function isAccountNonLocked(): bool
     {
         return $this->accountNonLocked;
     }
 
     /**
-     * {@inheritdoc}
+     * Checks whether the user's credentials (password) has expired.
+     *
+     * Internally, if this method returns false, the authentication system
+     * will throw a CredentialsExpiredException and prevent login.
+     *
+     * @return bool true if the user's credentials are non expired, false otherwise
+     *
+     * @see CredentialsExpiredException
      */
     public function isCredentialsNonExpired(): bool
     {
         return $this->credentialsNonExpired;
     }
 
     /**
-     * {@inheritdoc}
+     * Checks whether the user is enabled.
+     *
+     * Internally, if this method returns false, the authentication system
+     * will throw a DisabledException and prevent login.
+     *
+     * @return bool true if the user is enabled, false otherwise
+     *
+     * @see DisabledException
      */
     public function isEnabled(): bool
     {