From e3b3f416b57f5642ea25078485f7e9394ad04526 Mon Sep 17 00:00:00 2001 From: Nick Sutterer Date: Thu, 12 May 2011 09:31:36 +0200 Subject: added docs for AbC::UrlFor and AC::UrlFor. --- actionpack/lib/abstract_controller/url_for.rb | 6 ++++++ actionpack/lib/action_controller/metal/url_for.rb | 6 ++++++ 2 files changed, 12 insertions(+) (limited to 'actionpack') diff --git a/actionpack/lib/abstract_controller/url_for.rb b/actionpack/lib/abstract_controller/url_for.rb index e5d5bef6b4..d2245d0b0d 100644 --- a/actionpack/lib/abstract_controller/url_for.rb +++ b/actionpack/lib/abstract_controller/url_for.rb @@ -1,3 +1,9 @@ +# Includes #url_for into the host class (e.g. an abstract controller or mailer). The class +# has to provide a RouteSet by implementing the #_routes methods. Otherwise, an exception +# will be raised. +# +# Note that this module is completely decoupled from HTTP - the only requirement is a valid +# #_routes implementation. module AbstractController module UrlFor extend ActiveSupport::Concern diff --git a/actionpack/lib/action_controller/metal/url_for.rb b/actionpack/lib/action_controller/metal/url_for.rb index 6fc0cf1fb8..9a03033f48 100644 --- a/actionpack/lib/action_controller/metal/url_for.rb +++ b/actionpack/lib/action_controller/metal/url_for.rb @@ -1,3 +1,9 @@ +# Includes #url_for into the host class. The class has to provide a RouteSet by implementing +# the #_routes methods. Otherwise, an exception will be raised. +# +# In addition to AbstractController::UrlFor, this module accesses the HTTP layer to define +# url options like the +host+. In order to do so, this module requires the host class +# to implement #env, which needs to be a Rack-compatible environment hash. module ActionController module UrlFor extend ActiveSupport::Concern -- cgit v1.2.3