Merge pull request rails#49487 from yawboakye/clarify-login-procedure-expectation

Clarify `login_procedure`'s responsibility during request authentication

Author: rafaelfranca

actionpack/lib/action_controller/metal/http_authentication.rb

@@ -424,7 +424,9 @@ module Token
 
       module ControllerMethods
         # Authenticate using an HTTP Bearer token, or otherwise render an HTTP
-        # header requesting the client to send a Bearer token.
+        # header requesting the client to send a Bearer token. For the authentication
+        # to be considered successful, `login_procedure` should return a non-nil
+        # value. Typically, the authenticated user is returned.
         #
         # See ActionController::HttpAuthentication::Token for example usage.
         def authenticate_or_request_with_http_token(realm = "Application", message = nil, &login_procedure)