[Python-checkins] CVS: python/dist/src/Doc/api abstract.tex,1.2,1.3

[Fred L. Drake]

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

Modified Files:
	abstract.tex 
Log Message:
Added docs for PyObject_CallFunctionObArgs() and PyObject_CallMethodObArgs().
Minor cleanups & markup consistency fixes.


Index: abstract.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/abstract.tex,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** abstract.tex	2001/10/26 05:06:49	1.2
--- abstract.tex	2001/10/26 16:38:38	1.3
***************
*** 184,197 ****
  \end{cfuncdesc}
  
! \begin{cfuncdesc}{PyObject*}{PyObject_CallFunction}{PyObject *callable_object,
!                                                     char *format, ...}
!   Call a callable Python object \var{callable_object}, with a variable
    number of C arguments.  The C arguments are described using a
    \cfunction{Py_BuildValue()} style format string.  The format may be
    \NULL, indicating that no arguments are provided.  Returns the
    result of the call on success, or \NULL{} on failure.  This is the
!   equivalent of the Python expression
!   \samp{apply(\var{callable_object}\var{args})} or
!   \samp{\var{callable_object}(*\var{args})}.
    \bifuncindex{apply}
  \end{cfuncdesc}
--- 184,196 ----
  \end{cfuncdesc}
  
! \begin{cfuncdesc}{PyObject*}{PyObject_CallFunction}{PyObject *callable,
!                                                     char *format, \moreargs}
!   Call a callable Python object \var{callable}, with a variable
    number of C arguments.  The C arguments are described using a
    \cfunction{Py_BuildValue()} style format string.  The format may be
    \NULL, indicating that no arguments are provided.  Returns the
    result of the call on success, or \NULL{} on failure.  This is the
!   equivalent of the Python expression \samp{apply(\var{callable},
!   \var{args})} or \samp{\var{callable}(*\var{args})}.
    \bifuncindex{apply}
  \end{cfuncdesc}
***************
*** 199,203 ****
  
  \begin{cfuncdesc}{PyObject*}{PyObject_CallMethod}{PyObject *o,
!                                            char *method, char *format, ...}
    Call the method named \var{m} of object \var{o} with a variable
    number of C arguments.  The C arguments are described by a
--- 198,203 ----
  
  \begin{cfuncdesc}{PyObject*}{PyObject_CallMethod}{PyObject *o,
!                                                   char *method, char *format,
!                                                   \moreargs}
    Call the method named \var{m} of object \var{o} with a variable
    number of C arguments.  The C arguments are described by a
***************
*** 205,212 ****
    indicating that no arguments are provided. Returns the result of the
    call on success, or \NULL{} on failure.  This is the equivalent of
!   the Python expression \samp{\var{o}.\var{method}(\var{args})}.  Note
!   that special method names, such as \method{__add__()},
!   \method{__getitem__()}, and so on are not supported.  The specific
!   abstract-object routines for these must be used.
  \end{cfuncdesc}
  
--- 205,233 ----
    indicating that no arguments are provided. Returns the result of the
    call on success, or \NULL{} on failure.  This is the equivalent of
!   the Python expression \samp{\var{o}.\var{method}(\var{args})}.
! \end{cfuncdesc}
! 
! 
! \begin{cfuncdesc}{PyObject*}{PyObject_CallFunctionObArgs}{PyObject *callable,
!                                                           \moreargs,
!                                                           \code{NULL}}
!   Call a callable Python object \var{callable}, with a variable
!   number of \ctype{PyObject*} arguments.  The arguments are provided
!   as a variable number of parameters followed by \NULL.
!   Returns the result of the call on success, or \NULL{} on failure.
!   \versionadded{2.2}
! \end{cfuncdesc}
! 
! 
! \begin{cfuncdesc}{PyObject*}{PyObject_CallMethodObArgs}{PyObject *o,
!                                                         PyObject *name,
!                                                         \moreargs,
!                                                         \code{NULL}}
!   Calls a method of the object \var{o}, where the name of the method
!   is given as a Python string object in \var{name}.  It is called with
!   a variable number of \ctype{PyObject*} arguments.  The arguments are
!   provided as a variable number of parameters followed by \NULL.
!   Returns the result of the call on success, or \NULL{} on failure.
!   \versionadded{2.2}
  \end{cfuncdesc}