Provide a decorator to mark a keyword argument as deprecated

[twisted-trac]

	@wiml reported
Trac ID	trac#9844
Type	enhancement
Created	2020-06-02 08:18:06Z
Branch	https://github.com/twisted/twisted/tree/9844-wiml-deprecated-keyword

It's occasionally useful to deprecate just the use of a keyword argument (I want this for #9550).

Searchable metadata

trac-id__9844 9844
type__enhancement enhancement
reporter__wiml wiml
priority__normal normal
milestone__None None
branch__9844_wiml_deprecated_keyword 9844-wiml-deprecated-keyword
branch_author__ 
status__closed closed
resolution__fixed fixed
component__core core
keywords__None None
time__1591085886111971 1591085886111971
changetime__1591250361689153 1591250361689153
version__None None
owner__wiml wiml

[twisted-trac]

	@wiml set owner to @wiml @wiml set status to assigned

[twisted-trac]

	@wiml removed owner @wiml set status to new

[twisted-trac]

	@rodrigc set owner to @wiml

Approved: #1286 (review)

[twisted-trac]

	@wiml set status to closed

In changeset 9d2f14a

#!CommitTicketReference repository="" revision="9d2f14ac605d550eb714556f13ea4b0461ee4406"
Merge 9844-wiml-deprecated-keyword: New decorator t.p.deprecate.deprecatedKeywordParameter()

Author: wiml
Reviewer: rodrigc
Fixes: ticket:9844

[twisted-trac]

	@glyph commented

Yaaaay