From 4ab3e145755e2f079d65ac091b881fc82ba8826c Mon Sep 17 00:00:00 2001 From: mcaramba563 Date: Sat, 29 Nov 2025 20:30:03 +0300 Subject: [PATCH] gh-99521: add notation key explaining in built-in functions --- Doc/library/functions.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index 61799e303a1639..e2dc0a1d4d0df2 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1,6 +1,15 @@ .. XXX document all delegations to __special__ methods .. _built-in-funcs: +Notation +-------- + +In the function signatures that follow you may see some special markers: + +- ``/`` (a single forward slash) — indicates that the parameters before it are *positional-only*. Parameters to the left of ``/`` must be supplied positionally and cannot be passed as keyword arguments. For example, ``repr(object, /)`` means ``object`` is positional-only. + +- ``*`` (a single asterisk) — indicates that the parameters following it are *keyword-only* and must be supplied using their parameter names. + Built-in Functions ==================