From 081e0836414db639357f2c813b563cd6e05825c6 Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Sun, 27 Apr 2008 09:39:59 +0000 Subject: #2677: add note that not all functions may accept keyword args. --- Doc/reference/expressions.rst | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'Doc/reference') diff --git a/Doc/reference/expressions.rst b/Doc/reference/expressions.rst index 299ff5673e..c148533d9a 100644 --- a/Doc/reference/expressions.rst +++ b/Doc/reference/expressions.rst @@ -663,6 +663,14 @@ slots for which no default value is specified, a :exc:`TypeError` exception is raised. Otherwise, the list of filled slots is used as the argument list for the call. +.. note:: + + An implementation may provide builtin functions whose positional parameters do + not have names, even if they are 'named' for the purpose of documentation, and + which therefore cannot be supplied by keyword. In CPython, this is the case for + functions implemented in C that use :cfunc:`PyArg_ParseTuple` to parse their + arguments. + If there are more positional arguments than there are formal parameter slots, a :exc:`TypeError` exception is raised, unless a formal parameter using the syntax ``*identifier`` is present; in this case, that formal parameter receives a tuple -- cgit v1.2.1