diff --git a/actionpack/lib/action_controller/assertions.rb b/actionpack/lib/action_controller/assertions.rb
index 956e5da14051423851cb08de01183e7be3a57355..941201b3356a766cc5721d60da3e30303ba931b6 100644
--- a/actionpack/lib/action_controller/assertions.rb
+++ b/actionpack/lib/action_controller/assertions.rb
@@ -39,7 +39,7 @@ module ActionController #:nodoc:
#
# == Testing named routes
#
- # If you're using named routes, they can be easily tested using the original named routes methods straight in the test case.
+ # If you're using named routes, they can be easily tested using the original named routes' methods straight in the test case.
# Example:
#
# assert_redirected_to page_url(:title => 'foo')
diff --git a/actionpack/lib/action_controller/cookies.rb b/actionpack/lib/action_controller/cookies.rb
index d337491ecb306afaadf5239f722fa371a93bec0d..7990eab45eedf324114ed0ae19138dc1054b95ab 100644
--- a/actionpack/lib/action_controller/cookies.rb
+++ b/actionpack/lib/action_controller/cookies.rb
@@ -44,8 +44,8 @@ def initialize(controller)
update(@cookies)
end
- # Returns the value of the cookie by +name+ -- or nil if no such cookie exists. You set new cookies using either the cookie method
- # or cookies[]= (for simple name/value cookies without options).
+ # Returns the value of the cookie by +name+ -- or nil if no such cookie exists. You set new cookies using cookies[]=
+ # (for simple name/value cookies without options).
def [](name)
@cookies[name.to_s].value.first if @cookies[name.to_s] && @cookies[name.to_s].respond_to?(:value)
end
diff --git a/actionpack/lib/action_controller/flash.rb b/actionpack/lib/action_controller/flash.rb
index ac38b46f68325ad495e5c845889b895134f472a9..314d32e9f586cbb0ebf89ece2e1792b00337252f 100644
--- a/actionpack/lib/action_controller/flash.rb
+++ b/actionpack/lib/action_controller/flash.rb
@@ -96,7 +96,7 @@ def keep(k = nil)
use(k, false)
end
- # Marks the entire flash or a single flash entry to be discarded by the end of the current action
+ # Marks the entire flash or a single flash entry to be discarded by the end of the current action:
#
# flash.discard # discard the entire flash at the end of the current action
# flash.discard(:warning) # discard only the "warning" entry at the end of the current action
diff --git a/actionpack/lib/action_controller/helpers.rb b/actionpack/lib/action_controller/helpers.rb
index 66a88fc07f2dd73ec8e53fafd7bf157aa8377830..b42bc8a555a64da172d655e5af732020adb1b06f 100644
--- a/actionpack/lib/action_controller/helpers.rb
+++ b/actionpack/lib/action_controller/helpers.rb
@@ -19,16 +19,16 @@ class << self
end
# The Rails framework provides a large number of helpers for working with +assets+, +dates+, +forms+,
- # +numbers+ and Active Record objects, to name a few. These helpers are available to all templates
+ # +numbers+ and +ActiveRecord+ objects, to name a few. These helpers are available to all templates
# by default.
#
# In addition to using the standard template helpers provided in the Rails framework, creating custom helpers to
# extract complicated logic or reusable functionality is strongly encouraged. By default, the controller will
# include a helper whose name matches that of the controller, e.g., MyController will automatically
- # include MyHelper.
+ # include MyHelper.
#
# Additional helpers can be specified using the +helper+ class method in ActionController::Base or any
- # controller which inherits from it.
+ # controller which inherits from it.
#
# ==== Examples
# The +to_s+ method from the +Time+ class can be wrapped in a helper method to display a custom message if
@@ -88,7 +88,7 @@ def add_template_helper(helper_module) #:nodoc:
# helper FooHelper # => includes FooHelper
#
# When the argument is the symbol :all, the controller will includes all helpers from
- # app/views/helpers/**/*.rb under RAILS_ROOT
+ # app/views/helpers/**/*.rb under +RAILS_ROOT+.
# helper :all
#
# Additionally, the +helper+ class method can receive and evaluate a block, making the methods defined available
@@ -102,7 +102,7 @@ def add_template_helper(helper_module) #:nodoc:
# end
# end
#
- # Finally, all the above styles can be mixed together, and the helper method can be invokved with a mix of
+ # Finally, all the above styles can be mixed together, and the +helper+ method can be invokved with a mix of
# +symbols+, +strings+, +modules+ and blocks.
# helper(:three, BlindHelper) { def mice() 'mice' end }
#
@@ -139,14 +139,14 @@ def helper(*args, &block)
master_helper_module.module_eval(&block) if block_given?
end
- # Declare a controller method as a helper. For example,
+ # Declare a controller method as a helper. For example, the following
+ # makes the +current_user+ controller method available to the view:
# class ApplicationController < ActionController::Base
# helper_method :current_user
# def current_user
# @current_user ||= User.find(session[:user])
# end
# end
- # makes the +current_user+ controller method available in the view.
def helper_method(*methods)
methods.flatten.each do |method|
master_helper_module.module_eval <<-end_eval
@@ -157,11 +157,11 @@ def #{method}(*args, &block)
end
end
- # Declare a controller attribute as a helper. For example,
+ # Declares helper accessors for controller attributes. For example, the
+ # following adds new +name+ and name= instance methods to a
+ # controller and makes them available to the view:
# helper_attr :name
# attr_accessor :name
- # makes the name and name= controller methods available in the view.
- # The is a convenience wrapper for helper_method.
def helper_attr(*attrs)
attrs.flatten.each { |attr| helper_method(attr, "#{attr}=") }
end
diff --git a/actionpack/lib/action_controller/integration.rb b/actionpack/lib/action_controller/integration.rb
index 1a5c8af69a3d9989d86d3e6c7611d05d0d65744a..2bff3a7ae0b8309ea5d08ff4ebc945a65a00285f 100644
--- a/actionpack/lib/action_controller/integration.rb
+++ b/actionpack/lib/action_controller/integration.rb
@@ -51,7 +51,7 @@ class Session
# A reference to the response instance used by the last request.
attr_reader :response
- # Create an initialize a new Session instance.
+ # Create and initialize a new +Session+ instance.
def initialize
reset!
end