Correct flash discard rdoc. Closes #8502 [kampers]

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@6887 5ecf4fe2-1ee6-0310-87b1-e25e094e27de

actionpack/lib/action_controller/flash.rb

@@ -98,8 +98,8 @@ def keep(k = nil)
     
       # Marks the entire flash or a single flash entry to be discarded by the end of the current action
       #
-      #     flash.keep                 # keep entire flash available for the next action
-      #     flash.discard(:warning)    # discard the "warning" entry (it'll still be available for 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
       def discard(k = nil)
         use(k)
       end