Remove extra white spaces on ActionPack docs.

actionpack/lib/abstract_controller/base.rb

@@ -10,7 +10,7 @@ class ActionNotFound < StandardError; end
   # <tt>AbstractController::Base</tt> is a low-level API. Nobody should be
   # using it directly, and subclasses (like ActionController::Base) are
   # expected to provide their own +render+ method, since rendering means
-  # different things depending on the context.  
+  # different things depending on the context.
   class Base
     attr_internal :response_body
     attr_internal :action_name

actionpack/lib/abstract_controller/helpers.rb

@@ -67,7 +67,7 @@ def #{meth}(*args, &blk)
       #   helper FooHelper # => includes FooHelper
       #
       # When the argument is a string or symbol, the method will provide the "_helper" suffix, require the file
-      # and include the module in the template class.  The second form illustrates how to include custom helpers
+      # and include the module in the template class. The second form illustrates how to include custom helpers
       # when working with namespaced controllers, or other cases where the file containing the helper definition is not
       # in one of Rails' standard load paths:
       #   helper :foo             # => requires 'foo_helper' and includes FooHelper

actionpack/lib/action_controller/caching/actions.rb

@@ -39,8 +39,8 @@ module Caching
     # <tt>:action => 'list', :format => :xml</tt>.
     #
     # You can set modify the default action cache path by passing a
-    # <tt>:cache_path</tt> option.  This will be passed directly to
-    # <tt>ActionCachePath.path_for</tt>.  This is handy for actions with
+    # <tt>:cache_path</tt> option. This will be passed directly to
+    # <tt>ActionCachePath.path_for</tt>. This is handy for actions with
     # multiple possible routes that should be cached differently. If a
     # block is given, it is called with the current controller instance.
     #

actionpack/lib/action_controller/metal/data_streaming.rb

@@ -37,7 +37,7 @@ module DataStreaming
       #
       # The default Content-Type and Content-Disposition headers are
       # set to download arbitrary binary files in as many browsers as
-      # possible.  IE versions 4, 5, 5.5, and 6 are all known to have
+      # possible. IE versions 4, 5, 5.5, and 6 are all known to have
       # a variety of quirks (especially when downloading over SSL).
       #
       # Simple download:
@@ -58,8 +58,8 @@ module DataStreaming
       #
       # Also be aware that the document may be cached by proxies and browsers.
       # The Pragma and Cache-Control headers declare how the file may be cached
-      # by intermediaries.  They default to require clients to validate with
-      # the server before releasing cached responses.  See
+      # by intermediaries. They default to require clients to validate with
+      # the server before releasing cached responses. See
       # http://www.mnot.net/cache_docs/ for an overview of web caching and
       # http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9
       # for the Cache-Control header spec.

actionpack/lib/action_controller/metal/http_authentication.rb

@@ -400,7 +400,7 @@ def request_http_token_authentication(realm = "Application")
       # the present token and options.
       #
       # controller      - ActionController::Base instance for the current request.
-      # login_procedure - Proc to call if a token is present.  The Proc should
+      # login_procedure - Proc to call if a token is present. The Proc should
       #                   take 2 arguments:
       #                     authenticate(controller) { |token, options| ... }
       #
@@ -413,7 +413,7 @@ def authenticate(controller, &login_procedure)
         end
       end
 
-      # Parses the token and options out of the token authorization header.  If
+      # Parses the token and options out of the token authorization header. If
       # the header looks like this:
       #   Authorization: Token token="abc", nonce="def"
       # Then the returned token is "abc", and the options is {:nonce => "def"}

actionpack/lib/action_controller/metal/request_forgery_protection.rb

@@ -63,7 +63,7 @@ module ClassMethods
       #
       # Valid Options:
       #
-      # * <tt>:only/:except</tt> - Passed to the <tt>before_filter</tt> call.  Set which actions are verified.
+      # * <tt>:only/:except</tt> - Passed to the <tt>before_filter</tt> call. Set which actions are verified.
       def protect_from_forgery(options = {})
         self.request_forgery_protection_token ||= :authenticity_token
         prepend_before_filter :verify_authenticity_token, options
@@ -71,7 +71,7 @@ def protect_from_forgery(options = {})
     end
 
     protected
-      # The actual before_filter that is used.  Modify this to change how you handle unverified requests.
+      # The actual before_filter that is used. Modify this to change how you handle unverified requests.
       def verify_authenticity_token
         unless verified_request?
           logger.debug "WARNING: Can't verify CSRF token authenticity" if logger
@@ -83,7 +83,7 @@ def handle_unverified_request
         reset_session
       end
 
-      # Returns true or false if a request is verified.  Checks:
+      # Returns true or false if a request is verified. Checks:
       #
       # * is it a GET request?  Gets should be safe and idempotent
       # * Does the form_authenticity_token match the given token value from the params?

actionpack/lib/action_controller/vendor/html-scanner/html/sanitizer.rb

@@ -103,7 +103,7 @@ class WhiteListSanitizer < Sanitizer
     # Specifies the default Set of allowed shorthand css properties for the #sanitize and #sanitize_css helpers.
     self.shorthand_css_properties = Set.new(%w(background border margin padding))
 
-    # Sanitizes a block of css code.  Used by #sanitize when it comes across a style attribute
+    # Sanitizes a block of css code. Used by #sanitize when it comes across a style attribute
     def sanitize_css(style)
       # disallow urls
       style = style.to_s.gsub(/url\s*\(\s*[^\s)]+?\s*\)\s*/, ' ')

actionpack/lib/action_dispatch/http/mime_type.rb

@@ -47,7 +47,7 @@ class Type
     cattr_reader :html_types
 
     # These are the content types which browsers can generate without using ajax, flash, etc
-    # i.e. following a link, getting an image or posting a form.  CSRF protection
+    # i.e. following a link, getting an image or posting a form. CSRF protection
     # only needs to protect against these types.
     @@browser_generated_types = Set.new [:html, :url_encoded_form, :multipart_form, :text]
     cattr_reader :browser_generated_types
@@ -246,7 +246,7 @@ def =~(mime_type)
       end
     end
 
-    # Returns true if Action Pack should check requests using this Mime Type for possible request forgery.  See
+    # Returns true if Action Pack should check requests using this Mime Type for possible request forgery. See
     # ActionController::RequestForgeryProtection.
     def verify_request?
       @@browser_generated_types.include?(to_sym)

actionpack/lib/action_dispatch/http/request.rb

@@ -172,10 +172,10 @@ def ip
        )\.
     }x
 
-    # Determines originating IP address.  REMOTE_ADDR is the standard
-    # but will fail if the user is behind a proxy.  HTTP_CLIENT_IP and/or
+    # Determines originating IP address. REMOTE_ADDR is the standard
+    # but will fail if the user is behind a proxy. HTTP_CLIENT_IP and/or
     # HTTP_X_FORWARDED_FOR are set by proxies so check for these if
-    # REMOTE_ADDR is a proxy.  HTTP_X_FORWARDED_FOR may be a comma-
+    # REMOTE_ADDR is a proxy. HTTP_X_FORWARDED_FOR may be a comma-
     # delimited list in the case of multiple chained proxies; the last
     # address which is not trusted is the originating IP.
     def remote_ip

actionpack/lib/action_dispatch/middleware/cookies.rb

@@ -59,7 +59,7 @@ def cookie_jar
   # The option symbols for setting cookies are:
   #
   # * <tt>:value</tt> - The cookie's value or list of values (as an array).
-  # * <tt>:path</tt> - The path for which this cookie applies.  Defaults to the root
+  # * <tt>:path</tt> - The path for which this cookie applies. Defaults to the root
   #   of the application.
   # * <tt>:domain</tt> - The domain for which this cookie applies so you can
   #   restrict to the domain level. If you use a schema like www.example.com

actionpack/lib/action_dispatch/routing/mapper.rb

@@ -335,7 +335,7 @@ def root(options = {})
         #
         # [:on]
         #   Shorthand for wrapping routes in a specific RESTful context. Valid
-        #   values are +:member+, +:collection+, and +:new+.  Only use within
+        #   values are +:member+, +:collection+, and +:new+. Only use within
         #   <tt>resource(s)</tt> block. For example:
         #
         #      resource :bar do

actionpack/lib/action_dispatch/routing/url_for.rb

@@ -108,7 +108,7 @@ def url_options
       end
 
       # Generate a url based on the options provided, default_url_options and the
-      # routes defined in routes.rb.  The following options are supported:
+      # routes defined in routes.rb. The following options are supported:
       #
       # * <tt>:only_path</tt> - If true, the relative url is returned. Defaults to +false+.
       # * <tt>:protocol</tt> - The protocol to connect to. Defaults to 'http'.

actionpack/lib/action_dispatch/testing/assertions/routing.rb

@@ -7,18 +7,18 @@ module Assertions
     # Suite of assertions to test routes generated by \Rails and the handling of requests made to them.
     module RoutingAssertions
       # Asserts that the routing of the given +path+ was handled correctly and that the parsed options (given in the +expected_options+ hash)
-      # match +path+.  Basically, it asserts that \Rails recognizes the route given by +expected_options+.
+      # match +path+. Basically, it asserts that \Rails recognizes the route given by +expected_options+.
       #
-      # Pass a hash in the second argument (+path+) to specify the request method.  This is useful for routes
-      # requiring a specific HTTP method.  The hash should contain a :path with the incoming request path
+      # Pass a hash in the second argument (+path+) to specify the request method. This is useful for routes
+      # requiring a specific HTTP method. The hash should contain a :path with the incoming request path
       # and a :method containing the required HTTP verb.
       #
       #   # assert that POSTing to /items will call the create action on ItemsController
       #   assert_recognizes({:controller => 'items', :action => 'create'}, {:path => 'items', :method => :post})
       #
-      # You can also pass in +extras+ with a hash containing URL parameters that would normally be in the query string.  This can be used
-      # to assert that values in the query string string will end up in the params hash correctly.  To test query strings you must use the
-      # extras argument, appending the query string on the path directly will not work.  For example:
+      # You can also pass in +extras+ with a hash containing URL parameters that would normally be in the query string. This can be used
+      # to assert that values in the query string string will end up in the params hash correctly. To test query strings you must use the
+      # extras argument, appending the query string on the path directly will not work. For example:
       #
       #   # assert that a path of '/items/list/1?view=print' returns the correct options
       #   assert_recognizes({:controller => 'items', :action => 'list', :id => '1', :view => 'print'}, 'items/list/1', { :view => "print" })
@@ -49,7 +49,7 @@ def assert_recognizes(expected_options, path, extras={}, message=nil)
         assert_equal(expected_options, request.path_parameters, msg)
       end
 
-      # Asserts that the provided options can be used to generate the provided path.  This is the inverse of +assert_recognizes+.
+      # Asserts that the provided options can be used to generate the provided path. This is the inverse of +assert_recognizes+.
       # The +extras+ parameter is used to tell the request the names and values of additional request parameters that would be in
       # a query string. The +message+ parameter allows you to specify a custom error message for assertion failures.
       #
@@ -92,10 +92,10 @@ def assert_generates(expected_path, options, defaults={}, extras = {}, message=n
       end
 
       # Asserts that path and options match both ways; in other words, it verifies that <tt>path</tt> generates
-      # <tt>options</tt> and then that <tt>options</tt> generates <tt>path</tt>.  This essentially combines +assert_recognizes+
+      # <tt>options</tt> and then that <tt>options</tt> generates <tt>path</tt>. This essentially combines +assert_recognizes+
       # and +assert_generates+ into one step.
       #
-      # The +extras+ hash allows you to specify options that would normally be provided as a query string to the action.  The
+      # The +extras+ hash allows you to specify options that would normally be provided as a query string to the action. The
       # +message+ parameter allows you to specify a custom error message to display upon failure.
       #
       # ==== Examples

actionpack/lib/action_dispatch/testing/integration.rb

@@ -62,7 +62,7 @@ def head(path, parameters = nil, headers = nil)
       #
       # The request_method is +:get+, +:post+, +:put+, +:delete+ or +:head+; the
       # parameters are +nil+, a hash, or a url-encoded or multipart string;
-      # the headers are a hash.  Keys are automatically upcased and prefixed
+      # the headers are a hash. Keys are automatically upcased and prefixed
       # with 'HTTP_' if not already.
       def xml_http_request(request_method, path, parameters = nil, headers = nil)
         headers ||= {}

actionpack/lib/action_view/helpers/capture_helper.rb

@@ -27,7 +27,7 @@ module CaptureHelper
       #     "The current timestamp is #{Time.now}."
       #   end
       #
-      # You can then use that variable anywhere else.  For example:
+      # You can then use that variable anywhere else. For example:
       #
       #   <html>
       #   <head><title><%= @greeting %></title></head>
@@ -76,7 +76,7 @@ def capture(*args)
       #
       #   <%= stored_content %>
       #
-      # You can use the <tt>yield</tt> syntax alongside an existing call to <tt>yield</tt> in a layout.  For example:
+      # You can use the <tt>yield</tt> syntax alongside an existing call to <tt>yield</tt> in a layout. For example:
       #
       #   <%# This is the layout %>
       #   <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">

actionpack/lib/action_view/helpers/date_helper.rb

@@ -517,7 +517,7 @@ def select_hour(datetime, options = {}, html_options = {})
       #   # that is named 'due' rather than 'day'.
       #   select_day(my_time, :field_name => 'due')
       #
-      #   # Generates a select field for days with a custom prompt.  Use <tt>:prompt => true</tt> for a
+      #   # Generates a select field for days with a custom prompt. Use <tt>:prompt => true</tt> for a
       #   # generic prompt.
       #   select_day(5, :prompt => 'Choose day')
       #

actionpack/lib/action_view/helpers/form_options_helper.rb

@@ -125,7 +125,7 @@ module FormOptionsHelper
       # This allows the user to submit a form page more than once with the expected results of creating multiple records.
       # In addition, this allows a single partial to be used to generate form inputs for both edit and create forms.
       #
-      # By default, <tt>post.person_id</tt> is the selected option.  Specify <tt>:selected => value</tt> to use a different selection
+      # By default, <tt>post.person_id</tt> is the selected option. Specify <tt>:selected => value</tt> to use a different selection
       # or <tt>:selected => nil</tt> to leave all options unselected. Similarly, you can specify values to be disabled in the option
       # tags by specifying the <tt>:disabled</tt> option. This can either be a single value or an array of values to be disabled.
       def select(object, method, choices, options = {}, html_options = {})
@@ -255,7 +255,7 @@ def time_zone_select(object, method, priority_zones = nil, options = {}, html_op
       # Accepts a container (hash, array, enumerable, your type) and returns a string of option tags. Given a container
       # where the elements respond to first and last (such as a two-element array), the "lasts" serve as option values and
       # the "firsts" as option text. Hashes are turned into this form automatically, so the keys become "firsts" and values
-      # become lasts. If +selected+ is specified, the matching "last" or element will get the selected option-tag.  +selected+
+      # become lasts. If +selected+ is specified, the matching "last" or element will get the selected option-tag. +selected+
       # may also be an array of values to be selected when using a multiple select.
       #
       # Examples (call, result):
@@ -406,13 +406,13 @@ def option_groups_from_collection_for_select(collection, group_method, group_lab
       # wraps them with <tt><optgroup></tt> tags.
       #
       # Parameters:
-      # * +grouped_options+ - Accepts a nested array or hash of strings.  The first value serves as the
+      # * +grouped_options+ - Accepts a nested array or hash of strings. The first value serves as the
       #   <tt><optgroup></tt> label while the second value must be an array of options. The second value can be a
       #   nested array of text-value pairs. See <tt>options_for_select</tt> for more info.
       #    Ex. ["North America",[["United States","US"],["Canada","CA"]]]
       # * +selected_key+ - A value equal to the +value+ attribute for one of the <tt><option></tt> tags,
       #   which will have the +selected+ attribute set. Note: It is possible for this value to match multiple options
-      #   as you might have the same option in multiple groups.  Each will then get <tt>selected="selected"</tt>.
+      #   as you might have the same option in multiple groups. Each will then get <tt>selected="selected"</tt>.
       # * +prompt+ - set to true or a prompt string. When the select element doesn't have a value yet, this
       #   prepends an option with a generic prompt - "Please select" - or the given prompt string.
       #

actionpack/lib/action_view/helpers/form_tag_helper.rb

@@ -204,7 +204,7 @@ def hidden_field_tag(name, value = nil, options = {})
         text_field_tag(name, value, options.stringify_keys.update("type" => "hidden"))
       end
 
-      # Creates a file upload field.  If you are using file uploads then you will also need
+      # Creates a file upload field. If you are using file uploads then you will also need
       # to set the multipart option for the form tag:
       #
       #   <%= form_tag '/upload', :multipart => true do %>

actionpack/lib/action_view/helpers/sanitize_helper.rb

@@ -14,13 +14,13 @@ module SanitizeHelper
       #
       # It also strips href/src tags with invalid protocols, like javascript: especially.
       # It does its best to counter any  tricks that hackers may use, like throwing in
-      # unicode/ascii/hex values to get past the javascript: filters.  Check out
+      # unicode/ascii/hex values to get past the javascript: filters. Check out
       # the extensive test suite.
       #
       #   <%= sanitize @article.body %>
       #
       # You can add or remove tags/attributes if you want to customize it a bit.
-      # See ActionView::Base for full docs on the available options.  You can add
+      # See ActionView::Base for full docs on the available options. You can add
       # tags/attributes for single uses of +sanitize+ by passing either the
       # <tt>:attributes</tt> or <tt>:tags</tt> options:
       #
@@ -66,7 +66,7 @@ def sanitize_css(style)
         self.class.white_list_sanitizer.sanitize_css(style)
       end
 
-      # Strips all HTML tags from the +html+, including comments.  This uses the
+      # Strips all HTML tags from the +html+, including comments. This uses the
       # html-scanner tokenizer and so its HTML parsing ability is limited by
       # that of html-scanner.
       #
@@ -142,7 +142,7 @@ def sanitized_protocol_separator=(value)
           white_list_sanitizer.protocol_separator = value
         end
 
-        # Gets the HTML::FullSanitizer instance used by +strip_tags+.  Replace with
+        # Gets the HTML::FullSanitizer instance used by +strip_tags+. Replace with
         # any object that responds to +sanitize+.
         #
         #   class Application < Rails::Application
@@ -153,7 +153,7 @@ def full_sanitizer
           @full_sanitizer ||= HTML::FullSanitizer.new
         end
 
-        # Gets the HTML::LinkSanitizer instance used by +strip_links+.  Replace with
+        # Gets the HTML::LinkSanitizer instance used by +strip_links+. Replace with
         # any object that responds to +sanitize+.
         #
         #   class Application < Rails::Application

actionpack/lib/action_view/helpers/tag_helper.rb

@@ -94,7 +94,7 @@ def content_tag(name, content_or_options_with_block = nil, options = nil, escape
         end
       end
 
-      # Returns a CDATA section with the given +content+.  CDATA sections
+      # Returns a CDATA section with the given +content+. CDATA sections
       # are used to escape blocks of text containing characters which would
       # otherwise be recognized as markup. CDATA sections begin with the string
       # <tt><![CDATA[</tt> and end with (and may not contain) the string <tt>]]></tt>.

actionpack/lib/action_view/helpers/text_helper.rb

@@ -232,7 +232,7 @@ def word_wrap(text, *args)
       # considered as a linebreak and a <tt><br /></tt> tag is appended. This
       # method does not remove the newlines from the +text+.
       #
-      # You can pass any HTML attributes into <tt>html_options</tt>.  These
+      # You can pass any HTML attributes into <tt>html_options</tt>. These
       # will be added to all created paragraphs.
       #
       # ==== Options
@@ -267,7 +267,7 @@ def simple_format(text, html_options={}, options={})
 
       # Creates a Cycle object whose _to_s_ method cycles through elements of an
       # array every time it is called. This can be used for example, to alternate
-      # classes for table rows.  You can use named cycles to allow nesting in loops.
+      # classes for table rows. You can use named cycles to allow nesting in loops.
       # Passing a Hash as the last parameter with a <tt>:name</tt> key will create a
       # named cycle. The default name for a cycle without a +:name+ key is
       # <tt>"default"</tt>. You can manually reset a cycle by calling reset_cycle

actionpack/lib/action_view/helpers/url_helper.rb

@@ -160,7 +160,7 @@ def url_for(options = {})
       #
       # ==== Examples
       # Because it relies on +url_for+, +link_to+ supports both older-style controller/action/id arguments
-      # and newer RESTful routes.  Current Rails style favors RESTful routes whenever possible, so base
+      # and newer RESTful routes. Current Rails style favors RESTful routes whenever possible, so base
       # your application on resources and use
       #
       #   link_to "Profile", profile_path(@profile)
@@ -348,7 +348,7 @@ def button_to(name, options = {}, html_options = {})
       # Creates a link tag of the given +name+ using a URL created by the set of
       # +options+ unless the current request URI is the same as the links, in
       # which case only the name is returned (or the given block is yielded, if
-      # one exists).  You can give +link_to_unless_current+ a block which will
+      # one exists). You can give +link_to_unless_current+ a block which will
       # specialize the default behavior (e.g., show a "Start Here" link rather
       # than the link's text).
       #
@@ -375,7 +375,7 @@ def button_to(name, options = {}, html_options = {})
       #   </ul>
       #
       # The implicit block given to +link_to_unless_current+ is evaluated if the current
-      # action is the action given.  So, if we had a comments page and wanted to render a
+      # action is the action given. So, if we had a comments page and wanted to render a
       # "Go Back" link instead of a link to the comments page, we could do something like this...
       #
       #    <%=
@@ -579,7 +579,7 @@ def current_page?(options)
         url_string = url_for(options)
 
         # We ignore any extra parameters in the request_uri if the
-        # submitted url doesn't have any either.  This lets the function
+        # submitted url doesn't have any either. This lets the function
         # work with things like ?order=asc
         if url_string.index("?")
           request_uri = request.fullpath
@@ -641,7 +641,7 @@ def array_or_string_for_javascript(option)
 
         # Processes the +html_options+ hash, converting the boolean
         # attributes from true/false form into the form required by
-        # HTML/XHTML.  (An attribute is considered to be boolean if
+        # HTML/XHTML. (An attribute is considered to be boolean if
         # its name is listed in the given +bool_attrs+ array.)
         #
         # More specifically, for each boolean attribute in +html_options+
@@ -651,7 +651,7 @@ def array_or_string_for_javascript(option)
         #
         # if the associated +bool_value+ evaluates to true, it is
         # replaced with the attribute's name; otherwise the attribute is
-        # removed from the +html_options+ hash.  (See the XHTML 1.0 spec,
+        # removed from the +html_options+ hash. (See the XHTML 1.0 spec,
         # section 4.5 "Attribute Minimization" for more:
         # http://www.w3.org/TR/xhtml1/#h-4.5)
         #