Decorator indicating that parameter old of func is renamed to new.
The actual implementation of func should use new, not old. If old is passed
to func, a DeprecationWarning is emitted, and its value is used, even if new
is also passed by keyword.
Example:
@_api.rename_parameter("3.1", "bad_name", "good_name")
def func(good_name): ...The version in which the parameter was renamed.
The version in which the old parameter will be removed.
The old parameter name.
The new parameter name.