Give documentational consistency to authenticate_with_http_token [ci-skip]

Author: sato11

actionpack/lib/action_controller/metal/http_authentication.rb

@@ -431,8 +431,11 @@ def authenticate_or_request_with_http_token(realm = "Application", message = nil
           authenticate_with_http_token(&login_procedure) || request_http_token_authentication(realm, message)
         end
 
-        # Authenticate using an HTTP Bearer token. Returns true if
-        # authentication is successful, false otherwise.
+        # Authenticate using an HTTP Bearer token.
+        # Returns the return value of <tt>login_procedure</tt> if a
+        # token is found. Returns <tt>nil</tt> if no token is found.
+        #
+        # See ActionController::HttpAuthentication::Token for example usage.
         def authenticate_with_http_token(&login_procedure)
           Token.authenticate(self, &login_procedure)
         end