Polish the new deprecate_constant API docs

fxn · fxn · commit 6903ac45e876 · 2024-07-13T18:59:23.000+02:00
diff --git a/activesupport/lib/active_support/deprecation/constant_accessor.rb b/activesupport/lib/active_support/deprecation/constant_accessor.rb
@@ -44,7 +44,8 @@ def const_missing(missing_const_name)
           # The +deprecator+ keyword argument is the object that will print the
           # deprecation message, an instance of ActiveSupport::Deprecation.
           #
-          # With that in place, client code referencing <tt>A::B</tt> will see
+          # With that in place, references to <tt>A::B</tt> still work, they
+          # evaluate to <tt>C::D</tt> now, and trigger a deprecation warning:
           #
           #   DEPRECATION WARNING: A::B is deprecated! Use C::D instead.
           #   (called from ...)

Original file line number	Diff line number	Diff line change
`@@ -44,7 +44,8 @@ def const_missing(missing_const_name)`
`44`	`44`	`# The +deprecator+ keyword argument is the object that will print the`
`45`	`45`	`# deprecation message, an instance of ActiveSupport::Deprecation.`
`46`	`46`	`#`
`47`		`- # With that in place, client code referencing <tt>A::B</tt> will see`
	`47`	`+ # With that in place, references to <tt>A::B</tt> still work, they`
	`48`	`+ # evaluate to <tt>C::D</tt> now, and trigger a deprecation warning:`
`48`	`49`	`#`
`49`	`50`	`# DEPRECATION WARNING: A::B is deprecated! Use C::D instead.`
`50`	`51`	`# (called from ...)`