summaryrefslogtreecommitdiffstats
path: root/Doc/reference
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2008-04-27 09:39:59 (GMT)
committerGeorg Brandl <georg@python.org>2008-04-27 09:39:59 (GMT)
commitf8770fb5e2601ceab5ccf5a1313be9829207a5ed (patch)
tree29d255bd14ed1cdcec8e2f762d8c90a99c275be9 /Doc/reference
parent9f4f48114fbf2df3803a44a30cd14e11679403fe (diff)
downloadcpython-f8770fb5e2601ceab5ccf5a1313be9829207a5ed.zip
cpython-f8770fb5e2601ceab5ccf5a1313be9829207a5ed.tar.gz
cpython-f8770fb5e2601ceab5ccf5a1313be9829207a5ed.tar.bz2
#2677: add note that not all functions may accept keyword args.
Diffstat (limited to 'Doc/reference')
-rw-r--r--Doc/reference/expressions.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/Doc/reference/expressions.rst b/Doc/reference/expressions.rst
index 299ff56..c148533 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