Deprecation.warn is a really nice little method used in Rails to signify when a method has been deprecated.
I've been using this method in my own rails plugins, but I've noticed that the default warning:
Default.warn "This method is deprecated"
procuces this:
DEPRECATION WARNING: This method is deprecated See http://www.rubyonrails.org/deprecation for details.
The http://www.rubyonrails.org/deprecation for details bit is irrelevant for my own deprecated methods.
Now instead you set the detail message using this in your environment.rb or init.rb:
ActiveSupport::Deprecation.detail_message = "Custom message for each deprecation"
Thus allowing common folk to use this handy little method in their own applications/plugins.
This patch includes tests and improved deprecation docs
