diff --git a/activesupport/lib/active_support/deprecation/constant_accessor.rb b/activesupport/lib/active_support/deprecation/constant_accessor.rb
index 0eaaabb8a4..d6ff5b4dfa 100644
--- 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 ...)