We have a very strict NO code changes policy.

Revert "An updated description of Object#try to better reflect changes documented at http://is.gd/hdmo and http://is.gd/hdmQ"

This reverts commit 9290881.

activesupport/lib/active_support/core_ext/try.rb

@@ -1,9 +1,6 @@
 class Object
-  # Invokes the method identified by +symbol+, passing it any arguments 
-  # and/or the block specified, just like the regular Ruby <tt>Object#send</tt> does.
-  #
-  # *Unlike* that method however, a +NoMethodError+ exception will *not* be raised 
-  # and +nil+ will be returned instead, if the receiving object is a +nil+ object or NilClass.
+  # Tries to send the method only if object responds to it. Return +nil+ otherwise.
+  # It will also forward any arguments and/or block like Object#send does.
   #
   # ==== Examples
   #
@@ -15,15 +12,13 @@ class Object
   # With try
   #   @person.try(:name)
   #
-  # +try+ also accepts arguments and/or a block, for the method it is trying
+  # Try also accepts arguments/blocks for the method it is trying
   #   Person.try(:find, 1)
   #   @people.try(:collect) {|p| p.name}
   #--
-  # This method definition below is for rdoc purposes only. The alias_method call 
-  # below overrides it as an optimization since +try+ behaves like +Object#send+,
-  # unless called on +NilClass+.
-  def try(symbol, *args, &block)
-    send(symbol, *args, &block)
+  # This method def is for rdoc only. The alias_method below overrides it as an optimization.
+  def try(method, *args, &block)
+    send(method, *args, &block)
   end
   alias_method :try, :__send__
 end