diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst
index b04302821e0a2af..18f3dd4a14583e2 100644
--- a/Doc/library/warnings.rst
+++ b/Doc/library/warnings.rst
@@ -551,7 +551,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.