From 8692db59af8f0dc468b588963622e61ff982a925 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rafael=20Mendon=C3=A7a=20Fran=C3=A7a?= Date: Thu, 13 Sep 2012 14:02:18 -0300 Subject: Copy-edit deprecation relared documentation [ci skip] --- .../active_support/deprecation/proxy_wrappers.rb | 45 +++++++++++----------- 1 file changed, 23 insertions(+), 22 deletions(-) (limited to 'activesupport/lib/active_support/deprecation/proxy_wrappers.rb') diff --git a/activesupport/lib/active_support/deprecation/proxy_wrappers.rb b/activesupport/lib/active_support/deprecation/proxy_wrappers.rb index 2b8282c34e..17e69c34a5 100644 --- a/activesupport/lib/active_support/deprecation/proxy_wrappers.rb +++ b/activesupport/lib/active_support/deprecation/proxy_wrappers.rb @@ -27,14 +27,13 @@ module ActiveSupport # This DeprecatedObjectProxy transforms object to depracated object. # - # Example # @old_object = DeprecatedObjectProxy.new(Object.new, "Don't use this object anymore!") - # Example with custom deprecator # @old_object = DeprecatedObjectProxy.new(Object.new, "Don't use this object anymore!", deprecator_instance) # - # When someone execute any method expect +inspect+ on proxy object this will trigger +warn+ method on +deprecator_instance+ + # When someone execute any method expect +inspect+ on proxy object this will + # trigger +warn+ method on +deprecator_instance+. # - # Default deprecator is ActiveSupport::Deprecation + # Default deprecator is ActiveSupport::Deprecation class DeprecatedObjectProxy < DeprecationProxy def initialize(object, message, deprecator = ActiveSupport::Deprecation.instance) @object = object @@ -52,28 +51,30 @@ module ActiveSupport end end - # This DeprecatedInstanceVariableProxy transforms instance variable to depracated instance variable. + # This DeprecatedInstanceVariableProxy transforms instance variable to + # depracated instance variable. # - # Example - # class Example - # def initialize(deprecator) - # @request = ActiveSupport::Deprecation::DeprecatedInstanceVariableProxy.new(self, :request, :@request, deprecator) - # @_request = :a_request - # end + # class Example + # def initialize(deprecator) + # @request = ActiveSupport::Deprecation::DeprecatedInstanceVariableProxy.new(self, :request, :@request, deprecator) + # @_request = :a_request + # end # - # def request + # def request # @_request # end # - # def old_request + # def old_request # @request - # end - # end + # end + # end # - # When someone execute any method on @request variable this will trigger +warn+ method on +deprecator_instance+ - # and will fetch @_request variable via +request+ method and execute the same method on non-proxy instance variable. + # When someone execute any method on @request variable this will trigger + # +warn+ method on +deprecator_instance+ and will fetch @_request + # variable via +request+ method and execute the same method on non-proxy + # instance variable. # - # Default deprecator is ActiveSupport::Deprecation + # Default deprecator is ActiveSupport::Deprecation. class DeprecatedInstanceVariableProxy < DeprecationProxy def initialize(instance, method, var = "@#{method}", deprecator = ActiveSupport::Deprecation.instance) @instance = instance @@ -94,13 +95,13 @@ module ActiveSupport # This DeprecatedConstantProxy transforms constant to depracated constant. # - # Example # OLD_CONST = ActiveSupport::Deprecation::DeprecatedConstantProxy.new('OLD_CONST', 'NEW_CONST') - # Example with custom deprecator # OLD_CONST = ActiveSupport::Deprecation::DeprecatedConstantProxy.new('OLD_CONST', 'NEW_CONST', deprecator_instance) - # When someone use old constant this will trigger +warn+ method on +deprecator_instance+ # - # Default deprecator is ActiveSupport::Deprecation + # When someone use old constant this will trigger +warn+ method on + # +deprecator_instance+. + # + # Default deprecator is ActiveSupport::Deprecation. class DeprecatedConstantProxy < DeprecationProxy def initialize(old_const, new_const, deprecator = ActiveSupport::Deprecation.instance) @old_const = old_const -- cgit v1.2.3