Deprecate "args_for_retry" instead of removing it

Preserve backwards compatibility for gem-users that have overridden the
"args_for_retry" method.

Also, ensure that the tests for "args_for_retry", "retry_args" and
"retry_args_for_exception" are not overcomplicated, all we care about is
that they are hit.
YARDoc's should use the [deprecated tag](http://rubydoc.info/gems/yard/file/docs/Tags.md#deprecated)