Document when fallback_location is used [ci-skip]

If you're not familiar with how the `Referer` header works, you likely won't understand why you need to provide a fallback or under what circumstances it would be used. Hopefully this clarifies things a bit.

Document when fallback_location is used [ci-skip]
If you're not familiar with how the `Referer` header works, you likely won't understand why you need to provide a fallback or under what circumstances it would be used. Hopefully this clarifies things a bit.
91e3aa19 · Derek Prior · 7a6772c0 · 91e3aa19
隐藏空白更改
内联并排

Showing with 8 addition and 2 deletion

actionpack/lib/action_controller/metal/redirecting.rb actionpack/lib/action_controller/metal/redirecting.rb +8 -2

未找到文件。
--- a/actionpack/lib/action_controller/metal/redirecting.rb
+++ b/actionpack/lib/action_controller/metal/redirecting.rb
@@ -68,8 +68,14 @@ def redirect_to(options = {}, response_status = {}) #:doc:
      self.response_body = "<html><body>You are being <a href=\"#{ERB::Util.unwrapped_html_escape(location)}\">redirected</a>.</body></html>"
    end

-    # Redirects the browser to the page that issued the request if possible,
-    # otherwise redirects to provided default fallback location.
+    # Redirects the browser to the page that issued the request (the referrer)
+    # if possible, otherwise redirects to the provided default fallback
+    # location.
+    #
+    # The referrer information is pulled from the HTTP `Referer` (sic) header on
+    # the request. This is an optional header and its presence on the request is
+    # subject to browser security settings and user preferences. If the request
+    # is missing this header, the <tt>fallback_location</tt> will be used.
    #
    #   redirect_back fallback_location: { action: "show", id: 5 }
    #   redirect_back fallback_location: post