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