Fix RestClient::Request docs when used with yard

This moves a backwards compatibility comment.  It's currently replacing the class documentation, which means that most of the docs for this class are missing on rubydoc.info - http://rubydoc.info/gems/rest-client/RestClient/Request