[Python-checkins] python/dist/src/Doc/lib libxmlrpclib.tex, 1.14, 1.15

[loewis at users.sourceforge.net]

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

Modified Files:
	libxmlrpclib.tex 
Log Message:
Patch #531629: Add multicall support.


Index: libxmlrpclib.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libxmlrpclib.tex,v
retrieving revision 1.14
retrieving revision 1.15
diff -C2 -d -r1.14 -r1.15
*** libxmlrpclib.tex	22 Oct 2003 14:12:03 -0000	1.14
--- libxmlrpclib.tex	31 Oct 2003 13:49:36 -0000	1.15
***************
*** 253,256 ****
--- 253,285 ----
  \end{memberdesc}
  
+ \subsection{MultiCall Objects}
+ 
+ \versionadded{2.4}
+ 
+ In \url{http://www.xmlrpc.com/discuss/msgReader\$1208}, an approach
+ is presented to encapsulate multiple calls to a remote server into
+ a single request.
+ 
+ \begin{classdesc}{MultiCall}{server}
+ 
+ Create an object used to boxcar method calls. \var{server} is the
+ eventual target of the call. Calls can be made to the result object,
+ but they will immediately return \var{None}, and only store the
+ call name and parameters in the \class{MultiCall} object. Calling
+ the object itself causes all stored calls to be transmitted as
+ a single \code{system.multicall} request. The result of this call
+ is a generator; iterating over this generator yields the individual
+ results.
+ 
+ \end{classdesc}
+ 
+ A usage example of this class is
+ 
+ \begin{verbatim}
+ multicall = MultiCall(server_proxy)
+ multicall.add(2,3)
+ multicall.get_address("Guido")
+ add_result, address = multicall()
+ \end{verbatim}
  
  \subsection{Convenience Functions}