[Python-checkins] CVS: python/dist/src/Doc/lib libxmlrpclib.tex,1.1,1.2
Fred L. Drake
fdrake@users.sourceforge.net
Thu, 12 Jul 2001 16:39:26 -0700
Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv31371/lib
Modified Files:
libxmlrpclib.tex
Log Message:
Several markup adjustments so this will format and be more consistent with
the rest of the documnentation.
Index: libxmlrpclib.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libxmlrpclib.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -r1.1 -r1.2
*** libxmlrpclib.tex 2001/07/12 02:39:45 1.1
--- libxmlrpclib.tex 2001/07/12 23:39:24 1.2
***************
*** 18,32 ****
objects and XML on the wire.
! \begin{seealso}
! \seetitle{http://xmlrpc-c.sourceforge.net/xmlrpc-howto/xmlrpc-howto.html}
! {XML-RPC HOWTO}{A good description of XML operation and client
! software in several languages. Contains pretty much
! everything an XML-RPC client developer needs to know.}
! \seetitle{http://xmlrpc-c.sourceforge.net/hacks.php}
! {XML-RPC-Hacks page}{Extensions for various open-source
! libraries to support instrospection and multicall.}
! \end{seealso}
!
! \begin{classdesc}{Server}{\optional{uri\optional{, transport, encoding, verbose}}}
A \class{Server} instance is a server proxy that manages communication
with a remote XML-RPC server. The required first argument is a URI
--- 18,23 ----
objects and XML on the wire.
! \begin{classdesc}{Server}{\optional{uri\optional{, transport\optional{,
! encoding\optional{, verbose}}}}}
A \class{Server} instance is a server proxy that manages communication
with a remote XML-RPC server. The required first argument is a URI
***************
*** 51,74 ****
\begin{tableii}{l|l}{constant}{Name}{Meaning}
! \lineii{boolean}{The True and False constants that then module supplies}
\lineii{integers}{Pass in directly}
\lineii{floating-point numbers}{Pass in directly}
\lineii{strings}{Pass in directly}
\lineii{arrays}{Any Python sequence type containing conformable
! elements. Arrays are returned as lists}
\lineii{structures}{A Python dictionary. Keys must be strings,
! values may be any conformable type.}
\lineii{dates}{in seconds since the epoch; pass in an instance of the
! \class{DateTime} wrapper class}
! \lineii{binary data}{pass in an instance of the \class{Binary} wrapper class}
\end{tableii}
This is the full set of data types supported by XML-RPC. Method calls
! may also return a special \class{Fault} instance, used to signal XML-RPCserver
! errors, or a \class{ProtocolError} instance used to signal an error in
! the HTTP/HTTPS transport layer.
!
\end{classdesc}
\subsection{Server Objects \label{server-objects}}
--- 42,77 ----
\begin{tableii}{l|l}{constant}{Name}{Meaning}
! \lineii{boolean}{The \constant{True} and \constant{False} constants}
\lineii{integers}{Pass in directly}
\lineii{floating-point numbers}{Pass in directly}
\lineii{strings}{Pass in directly}
\lineii{arrays}{Any Python sequence type containing conformable
! elements. Arrays are returned as lists}
\lineii{structures}{A Python dictionary. Keys must be strings,
! values may be any conformable type.}
\lineii{dates}{in seconds since the epoch; pass in an instance of the
! \class{DateTime} wrapper class}
! \lineii{binary data}{pass in an instance of the \class{Binary}
! wrapper class}
\end{tableii}
This is the full set of data types supported by XML-RPC. Method calls
! may also raise a special \exception{Fault} instance, used to signal
! XML-RPC server errors, or \exception{ProtocolError} used to signal an
! error in the HTTP/HTTPS transport layer.
\end{classdesc}
+
+ \begin{seealso}
+ \seetitle[http://xmlrpc-c.sourceforge.net/xmlrpc-howto/xmlrpc-howto.html]
+ {XML-RPC HOWTO}{A good description of XML operation and
+ client software in several languages. Contains pretty much
+ everything an XML-RPC client developer needs to know.}
+ \seetitle[http://xmlrpc-c.sourceforge.net/hacks.php]
+ {XML-RPC-Hacks page}{Extensions for various open-source
+ libraries to support instrospection and multicall.}
+ \end{seealso}
+
+
\subsection{Server Objects \label{server-objects}}
***************
*** 121,130 ****
Perl, Python and Java is available at the XML-RPC Hacks page.
\subsection{Boolean Objects \label{boolean-objects}}
This class may be initialized from any Python value; the instance
! returned depends onlyon its truth value. It supports various Python
! operators through \class{__cmp__}, \class{__repr__}, \class{__int__},
! and \class{__nonzero__} methods, all implemented in the obvious ways.
It also has the following method, supported mainly for internal use by
--- 124,135 ----
Perl, Python and Java is available at the XML-RPC Hacks page.
+
\subsection{Boolean Objects \label{boolean-objects}}
This class may be initialized from any Python value; the instance
! returned depends only on its truth value. It supports various Python
! operators through \method{__cmp__()}, \method{__repr__()},
! \method{__int__()}, and \method{__nonzero__()} methods, all
! implemented in the obvious ways.
It also has the following method, supported mainly for internal use by
***************
*** 135,138 ****
--- 140,144 ----
\end{methoddesc}
+
\subsection{DateTime Objects \label{datetime-objects}}
***************
*** 153,156 ****
--- 159,163 ----
\method{_cmp__} and \method{__repr__} methods.
+
\subsection{Binary Objects \label{binary-objects}}
***************
*** 164,168 ****
\begin{methoddesc}{encode}{out}
! Write the XML-RPC base 64 encoding of this binary item to the out stream object.
\end{methoddesc}
--- 171,176 ----
\begin{methoddesc}{encode}{out}
! Write the XML-RPC base 64 encoding of this binary item to the out
! stream object.
\end{methoddesc}
***************
*** 170,173 ****
--- 178,182 ----
\method{_cmp__} method.
+
\subsection{Fault Objects \label{fault-objects}}
***************
*** 183,186 ****
--- 192,196 ----
\end{memberdesc}
+
\subsection{ProtocolError Objects \label{protocol-error-objects}}
***************
*** 207,210 ****
--- 217,221 ----
\end{memberdesc}
+
\subsection{Convenience Functions}
***************
*** 219,237 ****
\end{funcdesc}
- \subsection{Example of Client Usage
\begin{verbatim}
! # simple test program (from the XML-RPC specification)
! # server = Server("http://localhost:8000") # local server
! server = Server("http://betty.userland.com")
! print server
! try:
! print server.examples.getStateName(41)
! except Error, v:
! print "ERROR", v
\end{verbatim}
-
- % End
--- 230,247 ----
\end{funcdesc}
+ \subsection{Example of Client Usage \label{xmlrpc-client-example}}
+
\begin{verbatim}
! # simple test program (from the XML-RPC specification)
! # server = Server("http://localhost:8000") # local server
! server = Server("http://betty.userland.com")
! print server
! try:
! print server.examples.getStateName(41)
! except Error, v:
! print "ERROR", v
\end{verbatim}