diff --git a/actionpack/lib/action_controller/verification.rb b/actionpack/lib/action_controller/verification.rb
index cd6f777486f70d300d9b8338362179ad42c3d19d..8e0b255f26f7468d12518993d412a6d839497854 100644
--- a/actionpack/lib/action_controller/verification.rb
+++ b/actionpack/lib/action_controller/verification.rb
@@ -17,14 +17,18 @@ def self.included(base) #:nodoc:
# Usage:
#
# class GlobalController < ActionController::Base
- # # prevent the #update_settings action from being invoked unless
- # # the 'admin_privileges' request parameter exists.
+ # # Prevent the #update_settings action from being invoked unless
+ # # the 'admin_privileges' request parameter exists. The
+ # # settings action will be redirected to in current controller
+ # # if verification fails.
# verify :params => "admin_privileges", :only => :update_post,
# :redirect_to => { :action => "settings" }
#
- # # disallow a post from being updated if there was no information
+ # # Disallow a post from being updated if there was no information
# # submitted with the post, and if there is no active post in the
- # # session, and if there is no "note" key in the flash.
+ # # session, and if there is no "note" key in the flash. The route
+ # # named category_url will be redirected to if verification fails.
+ #
# verify :params => "post", :session => "post", "flash" => "note",
# :only => :update_post,
# :add_flash => { "alert" => "Failed to create your message" },
@@ -54,7 +58,8 @@ module ClassMethods
# merged into the response's headers hash if the prerequisites cannot
# be satisfied.
# * :redirect_to: the redirection parameters to be used when
- # redirecting if the prerequisites cannot be satisfied.
+ # redirecting if the prerequisites cannot be satisfied. You can
+ # redirect either to named route or to the action in some controller.
# * :render: the render parameters to be used when
# the prerequisites cannot be satisfied.
# * :only: only apply this verification to the actions specified