aboutsummaryrefslogtreecommitdiffstats
path: root/actionpack
diff options
context:
space:
mode:
authorWincent Colaiuta <win@wincent.com>2010-07-26 16:59:22 +0200
committerXavier Noria <fxn@hashref.com>2010-07-26 18:55:51 +0200
commitc819c131f2d08a8c9089a6ef0dcadcf912e2538c (patch)
treed28f1c4611da7a9edd5d2ec56ddd03752efbc33e /actionpack
parentfd589db8633ef3eda398365f2a6d551edfed547e (diff)
downloadrails-c819c131f2d08a8c9089a6ef0dcadcf912e2538c.tar.gz
rails-c819c131f2d08a8c9089a6ef0dcadcf912e2538c.tar.bz2
rails-c819c131f2d08a8c9089a6ef0dcadcf912e2538c.zip
doc: cleanup respond_to documentation
Signed-off-by: Wincent Colaiuta <win@wincent.com>
Diffstat (limited to 'actionpack')
-rw-r--r--actionpack/lib/action_controller/metal/mime_responds.rb21
1 files changed, 12 insertions, 9 deletions
diff --git a/actionpack/lib/action_controller/metal/mime_responds.rb b/actionpack/lib/action_controller/metal/mime_responds.rb
index c12e5797ae..c6d4c6d936 100644
--- a/actionpack/lib/action_controller/metal/mime_responds.rb
+++ b/actionpack/lib/action_controller/metal/mime_responds.rb
@@ -12,27 +12,30 @@ module ActionController #:nodoc:
end
module ClassMethods
- # Defines mimes that are rendered by default when invoking respond_with.
+ # Defines mime types that are rendered by default when invoking
+ # <tt>respond_with</tt>.
#
# Examples:
#
# respond_to :html, :xml, :json
#
- # All actions on your controller will respond to :html, :xml and :json.
+ # Specifies that all actions in the controller respond to requests
+ # for <tt>:html</tt>, <tt>:xml</tt> and <tt>:json</tt>.
#
- # But if you want to specify it based on your actions, you can use only and
- # except:
+ # To specify on per-action basis, use <tt>:only</tt> and
+ # <tt>:except</tt> with an array of actions or a single action:
#
# respond_to :html
# respond_to :xml, :json, :except => [ :edit ]
#
- # The definition above explicits that all actions respond to :html. And all
- # actions except :edit respond to :xml and :json.
- #
- # You can specify also only parameters:
+ # This specifies that all actions respond to <tt>:html</tt>
+ # and all actions except <tt>:edit</tt> respond to <tt>:xml</tt> and
+ # <tt>:json</tt>.
#
# respond_to :rjs, :only => :create
#
+ # This specifies that the <tt>:create</tt> action and no other responds
+ # to <tt>:rjs</tt>.
def respond_to(*mimes)
options = mimes.extract_options!
@@ -49,7 +52,7 @@ module ActionController #:nodoc:
self.mimes_for_respond_to = new.freeze
end
- # Clear all mimes in respond_to.
+ # Clear all mime types in <tt>respond_to</tt>.
#
def clear_respond_to
self.mimes_for_respond_to = ActiveSupport::OrderedHash.new.freeze