[Python-checkins] CVS: python/dist/src/Doc/lib libfuncs.tex,1.94,1.95

[Fred L. Drake]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv19297/lib

Modified Files:
	libfuncs.tex 
Log Message:
apply() documentation:  Remove a detail about the implementation that does
not affect the API.  Clean up the text about call syntax apply() is
equivalent to.  Based on comments by Thomas Guettler.


Index: libfuncs.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libfuncs.tex,v
retrieving revision 1.94
retrieving revision 1.95
diff -C2 -d -r1.94 -r1.95
*** libfuncs.tex	2001/10/29 22:25:44	1.94
--- libfuncs.tex	2001/11/07 06:22:25	1.95
***************
*** 66,78 ****
    The \var{function} argument must be a callable object (a
    user-defined or built-in function or method, or a class object) and
!   the \var{args} argument must be a sequence (if it is not a tuple,
!   the sequence is first converted to a tuple).  The \var{function} is
    called with \var{args} as the argument list; the number of arguments
!   is the the length of the tuple.  (This is different from just
!   calling \code{\var{func}(\var{args})}, since in that case there is
!   always exactly one argument.)
    If the optional \var{keywords} argument is present, it must be a
    dictionary whose keys are strings.  It specifies keyword arguments
    to be added to the end of the the argument list.
  \end{funcdesc}
  
--- 66,79 ----
    The \var{function} argument must be a callable object (a
    user-defined or built-in function or method, or a class object) and
!   the \var{args} argument must be a sequence.  The \var{function} is
    called with \var{args} as the argument list; the number of arguments
!   is the the length of the tuple.
    If the optional \var{keywords} argument is present, it must be a
    dictionary whose keys are strings.  It specifies keyword arguments
    to be added to the end of the the argument list.
+   Calling \function{apply()} is different from just calling
+   \code{\var{func}(\var{args})}, since in that case there is always
+   exactly one argument.  The use of \function{apply()} is equivalent
+   to \code{\var{function}(*\var{args}, **\var{keywords})}.
  \end{funcdesc}