1 files changed, 30 insertions, 11 deletions
diff --git a/actionpack/lib/action_controller/new_base/http.rb b/actionpack/lib/action_controller/new_base/http.rb
index b3a80094dd..2e73561f93 100644
--- a/actionpack/lib/action_controller/new_base/http.rb
+++ b/actionpack/lib/action_controller/new_base/http.rb
@@ -2,38 +2,48 @@ require 'action_controller/abstract'
 require 'active_support/core_ext/module/delegation'
 
 module ActionController
+  # ActionController::Http provides a way to get a valid Rack application from a controller.
+  #
+  # In AbstractController, dispatching is triggered directly by calling #process on a new controller.
+  # ActionController::Http provides an #action method that returns a valid Rack application for a
+  # given action. Other rack builders, such as Rack::Builder, Rack::URLMap, and the Rails router,
+  # can dispatch directly to the action returned by FooController.action(:index).
   class Http < AbstractController::Base
     abstract!
 
     # :api: public
     attr_internal :params, :env
 
-    # :api: public
+    # Returns the last part of the controller's name, underscored, without the ending
+    # "Controller". For instance, MyApp::MyPostsController would return "my_posts" for
+    # controller_name
+    #
+    # ==== Returns
+    # String
     def self.controller_name
       @controller_name ||= controller_path.split("/").last
     end
 
-    # :api: public
+    # Delegates to the class' #controller_name
     def controller_name
       self.class.controller_name
     end
 
-    # :api: public
+    # Returns the full controller name, underscored, without the ending Controller.
+    # For instance, MyApp::MyPostsController would return "my_app/my_posts" for
+    # controller_name.
+    #
+    # ==== Returns
+    # String
     def self.controller_path
       @controller_path ||= self.name.sub(/Controller$/, '').underscore
     end
 
-    # :api: public
+    # Delegates to the class' #controller_path
     def controller_path
       self.class.controller_path
     end
 
-    # :api: plugin
-    def self.call(env)
-      controller = new
-      controller.call(env).to_rack
-    end
-
     # The details below can be overridden to support a specific
     # Request and Response object. The default ActionController::Base
     # implementation includes RackConvenience, which makes a request
@@ -47,7 +57,7 @@ module ActionController
       super
     end
 
-    # Basic implements for content_type=, location=, and headers are
+    # Basic implementations for content_type=, location=, and headers are
     # provided to reduce the dependency on the RackConvenience module
     # in Renderer and Redirector.
 
@@ -71,6 +81,15 @@ module ActionController
       [status, headers, response_body]
     end
 
+    # Return a rack endpoint for the given action. Memoize the endpoint, so
+    # multiple calls into MyController.action will return the same object
+    # for the same action.
+    #
+    # ==== Parameters
+    # action<#to_s>:: An action name
+    #
+    # ==== Returns
+    # Proc:: A rack application
     def self.action(name)
       @actions ||= {}
       @actions[name.to_s] ||= proc do |env|