# File lib/rspec/core/deprecation.rb, line 6
    def deprecate(method, alternate_method=nil, version=nil)
      version_string = version ? "rspec-#{version}" : "a future version of RSpec"

      message = "\n*****************************************************************\nDEPRECATION WARNING: you are using deprecated behaviour that will\nbe removed from \#{version_string}.\n\n\#{caller(0)[2]}\n\n* \#{method} is deprecated.\n"
      if alternate_method
        message << "* please use \#{alternate_method} instead.\n"
      end

      message << "*****************************************************************"
      warn_deprecation(message)
    end