[Python-checkins] r62521 - python/trunk/Doc/reference/expressions.rst

[georg.brandl]

Author: georg.brandl
Date: Sun Apr 27 11:39:59 2008
New Revision: 62521

Log:
#2677: add note that not all functions may accept keyword args.


Modified:
   python/trunk/Doc/reference/expressions.rst

Modified: python/trunk/Doc/reference/expressions.rst
==============================================================================
--- python/trunk/Doc/reference/expressions.rst	(original)
+++ python/trunk/Doc/reference/expressions.rst	Sun Apr 27 11:39:59 2008
@@ -663,6 +663,14 @@
 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