diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst
index 9063bea96ccb0a..d5f89102d5853b 100644
--- a/Doc/library/warnings.rst
+++ b/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.