update AS/deprecation docs [ci skip]

activesupport/lib/active_support/deprecation/behaviors.rb

@@ -6,13 +6,13 @@ class << self
       # Whether to print a backtrace along with the warning.
       attr_accessor :debug
 
-      # Returns the current behavior or if one isn't set, defaults to +:stderr+
+      # Returns the current behavior or if one isn't set, defaults to +:stderr+.
       def behavior
         @behavior ||= [DEFAULT_BEHAVIORS[:stderr]]
       end
 
-      # Sets the behavior to the specified value. Can be a single value, array, or
-      # an object that responds to +call+.
+      # Sets the behavior to the specified value. Can be a single value, array,
+      # or an object that responds to +call+.
       #
       # Available behaviors:
       #
@@ -22,13 +22,13 @@ def behavior
       # [+silence+] Do nothing.
       #
       # Setting behaviors only affects deprecations that happen after boot time.
-      # Deprecation warnings raised by gems are not affected by this setting because
-      # they happen before Rails boots up.
+      # Deprecation warnings raised by gems are not affected by this setting
+      # because they happen before Rails boots up.
       #
       #   ActiveSupport::Deprecation.behavior = :stderr
       #   ActiveSupport::Deprecation.behavior = [:stderr, :log]
       #   ActiveSupport::Deprecation.behavior = MyCustomHandler
-      #   ActiveSupport::Deprecation.behavior = proc { |message, callstack| 
+      #   ActiveSupport::Deprecation.behavior = proc { |message, callstack|
       #     # custom stuff
       #   }
       def behavior=(behavior)

activesupport/lib/active_support/deprecation/reporting.rb

@@ -6,7 +6,7 @@ class << self
       # Outputs a deprecation warning to the output configured by
       # <tt>ActiveSupport::Deprecation.behavior</tt>.
       #
-      #   ActiveSupport::Deprecation.warn("something broke!")
+      #   ActiveSupport::Deprecation.warn('something broke!')
       #   # => "DEPRECATION WARNING: something broke! (called from your_code.rb:1)"
       def warn(message = nil, callstack = caller)
         return if silenced
@@ -17,11 +17,11 @@ def warn(message = nil, callstack = caller)
 
       # Silence deprecation warnings within the block.
       #
-      #   ActiveSupport::Deprecation.warn("something broke!")
+      #   ActiveSupport::Deprecation.warn('something broke!')
       #   # => "DEPRECATION WARNING: something broke! (called from your_code.rb:1)"
       #
       #   ActiveSupport::Deprecation.silence do
-      #     ActiveSupport::Deprecation.warn("something broke!")
+      #     ActiveSupport::Deprecation.warn('something broke!')
       #   end
       #   # => nil
       def silence