From f8d0c075b2290908cf0db7a6d0a68c2d0d690fea Mon Sep 17 00:00:00 2001 From: "Andrew M. Kuchling" Date: Fri, 25 Apr 2003 00:29:31 +0000 Subject: [PATCH] [Patch #628208] Document the allow_none argument --- Doc/lib/libxmlrpclib.tex | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/Doc/lib/libxmlrpclib.tex b/Doc/lib/libxmlrpclib.tex index b7bccdb51d5..59d34a76cda 100644 --- a/Doc/lib/libxmlrpclib.tex +++ b/Doc/lib/libxmlrpclib.tex @@ -18,7 +18,8 @@ handles all the details of translating between conformable Python objects and XML on the wire. \begin{classdesc}{ServerProxy}{uri\optional{, transport\optional{, - encoding\optional{, verbose}}}} + encoding\optional{, verbose\optional{, + allow_none}}}}} A \class{ServerProxy} instance is an object that manages communication with a remote XML-RPC server. The required first argument is a URI (Uniform Resource Indicator), and will normally be the URL of the @@ -26,7 +27,12 @@ server. The optional second argument is a transport factory instance; by default it is an internal \class{SafeTransport} instance for https: URLs and an internal HTTP \class{Transport} instance otherwise. The optional third argument is an encoding, by default UTF-8. The optional -fourth argument is a debugging flag. +fourth argument is a debugging flag. If \var{allow_none} is true, +the Python constant \code{None} will be translated into XML; the +default behaviour is for \code{None} to raise a \exception{TypeError}. +This is a commonly-used extension to the XML-RPC specification, but isn't +supported by all clients and servers; see +\url{http://ontosys.com/xml-rpc/extensions.html} for a description. Both the HTTP and HTTPS transports support the URL syntax extension for HTTP Basic Authentication: \code{http://user:pass@host:port/path}. The