deprecate only a specific argument of a function

[grst]

Description of feature

e.g. a keyword argument that doesn't have any effect anymore, but is kept around not to break the function signature.

If the keyword is used, a FutureWarning should be emitted.

That's not yet supported by the @deprecated decorator, is it?

[flying-sheep]

Not yet and probably not ever, @warnings.deprecated is marks the whole things it decorates as deprecated on the type level, so I doubt it’ll change to a more narrow scope.

We’d need to make/use a different decorator.