diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst
index 93832e8faa37e45..7bcdb3adc0cf36e 100644
--- a/Doc/library/warnings.rst
+++ b/Doc/library/warnings.rst
@@ -544,7 +544,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.