From 920abaa52d9b0d62cf846477ed51d5a2e8e1dc8c Mon Sep 17 00:00:00 2001 From: Jo Liss Date: Thu, 20 Sep 2012 18:29:12 +0200 Subject: Fix indentation and update documentation for Array#wrap for Ruby 1.9 --- .../lib/active_support/core_ext/array/wrap.rb | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/activesupport/lib/active_support/core_ext/array/wrap.rb b/activesupport/lib/active_support/core_ext/array/wrap.rb index 55582c6487..7bf28b2f27 100644 --- a/activesupport/lib/active_support/core_ext/array/wrap.rb +++ b/activesupport/lib/active_support/core_ext/array/wrap.rb @@ -7,17 +7,17 @@ class Array # * Otherwise, if the argument responds to +to_ary+ it is invoked, and its result returned. # * Otherwise, returns an array with the argument as its single element. # - # Array.wrap(nil) # => [] - # Array.wrap([1, 2, 3]) # => [1, 2, 3] - # Array.wrap(0) # => [0] + # Array.wrap(nil) # => [] + # Array.wrap([1, 2, 3]) # => [1, 2, 3] + # Array.wrap(0) # => [0] # # This method is similar in purpose to Kernel#Array, but there are some differences: # # * If the argument responds to +to_ary+ the method is invoked. Kernel#Array - # moves on to try +to_a+ if the returned value is +nil+, but Array.wrap returns - # such a +nil+ right away. + # moves on to try +to_a+ if the returned value is +nil+, but Array.wrap returns + # such a +nil+ right away. # * If the returned value from +to_ary+ is neither +nil+ nor an +Array+ object, Kernel#Array - # raises an exception, while Array.wrap does not, it just returns the value. + # raises an exception, while Array.wrap does not, it just returns the value. # * It does not call +to_a+ on the argument, though special-cases +nil+ to return an empty array. # # The last point is particularly worth comparing for some enumerables: @@ -29,10 +29,11 @@ class Array # # [*object] # - # which returns [nil] for +nil+, and calls to Array(object) otherwise. + # which for +nil+ returns [nil] (Ruby 1.8.7) or [] (Ruby + # 1.9), and calls to Array(object) otherwise. # - # Thus, in this case the behavior is different for +nil+, and the differences with - # Kernel#Array explained above apply to the rest of +object+s. + # Thus, in this case the behavior may be different for +nil+, and the differences with + # Kernel#Array explained above apply to the rest of objects. def self.wrap(object) if object.nil? [] -- cgit v1.2.3