pythongh-150076: Fix the documented signature of warnings.deprecated (python#153879)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

Author: fedonman

Doc/library/warnings.rst

@@ -566,7 +566,7 @@ Available Functions
    and calls to :func:`simplefilter`.
 
 
-.. decorator:: deprecated(msg, *, category=DeprecationWarning, stacklevel=1)
+.. decorator:: deprecated(message, /, *, category=DeprecationWarning, stacklevel=1)
 
    Decorator to indicate that a class, function or overload is deprecated.