[ci skip] Update XML-RPC library docs
diff --git a/user_guide_src/source/libraries/xmlrpc.rst b/user_guide_src/source/libraries/xmlrpc.rst
index a43c488..c79f8be 100644
--- a/user_guide_src/source/libraries/xmlrpc.rst
+++ b/user_guide_src/source/libraries/xmlrpc.rst
@@ -5,6 +5,13 @@
CodeIgniter's XML-RPC classes permit you to send requests to another
server, or set up your own XML-RPC server to receive requests.
+.. contents::
+ :local:
+
+.. raw:: html
+
+ <div class="custom-index container"></div>
+
****************
What is XML-RPC?
****************
@@ -24,8 +31,11 @@
request. Once processed, the server will then send back a response
message.
-For detailed specifications, you can visit the
-`XML-RPC <http://www.xmlrpc.com/>`_ site.
+For detailed specifications, you can visit the `XML-RPC <http://www.xmlrpc.com/>`_ site.
+
+***********************
+Using the XML-RPC Class
+***********************
Initializing the Class
======================
@@ -123,6 +133,7 @@
The `Data Types <#datatypes>`_ section below has a full list of data
types.
+
Creating an XML-RPC Server
==========================
@@ -425,102 +436,6 @@
$size = $parameters[1]['size'];
$shape = $parameters[1]['shape'];
-**************************
-XML-RPC Function Reference
-**************************
-
-$this->xmlrpc->server()
-=======================
-
-Sets the URL and port number of the server to which a request is to be
-sent::
-
- $this->xmlrpc->server('http://www.sometimes.com/pings.php', 80);
-
-$this->xmlrpc->timeout()
-========================
-
-Set a time out period (in seconds) after which the request will be
-canceled::
-
- $this->xmlrpc->timeout(6);
-
-$this->xmlrpc->method()
-=======================
-
-Sets the method that will be requested from the XML-RPC server::
-
- $this->xmlrpc->method('method');
-
-Where method is the name of the method.
-
-$this->xmlrpc->request()
-========================
-
-Takes an array of data and builds request to be sent to XML-RPC server::
-
- $request = array(array('My Photoblog', 'string'), 'http://www.yoursite.com/photoblog/');
- $this->xmlrpc->request($request);
-
-$this->xmlrpc->send_request()
-==============================
-
-The request sending function. Returns boolean TRUE or FALSE based on
-success for failure, enabling it to be used conditionally.
-
-$this->xmlrpc->set_debug(TRUE);
-================================
-
-Enables debugging, which will display a variety of information and error
-data helpful during development.
-
-$this->xmlrpc->display_error()
-===============================
-
-Returns an error message as a string if your request failed for some
-reason.
-
-::
-
- echo $this->xmlrpc->display_error();
-
-$this->xmlrpc->display_response()
-==================================
-
-Returns the response from the remote server once request is received.
-The response will typically be an associative array.
-
-::
-
- $this->xmlrpc->display_response();
-
-$this->xmlrpc->send_error_message()
-=====================================
-
-This function lets you send an error message from your server to the
-client. First parameter is the error number while the second parameter
-is the error message.
-
-::
-
- return $this->xmlrpc->send_error_message('123', 'Requested data not available');
-
-$this->xmlrpc->send_response()
-===============================
-
-Lets you send the response from your server to the client. An array of
-valid data values must be sent with this method.
-
-::
-
- $response = array(
- array(
- 'flerror' => array(FALSE, 'boolean'),
- 'message' => "Thanks for the ping!"
- )
- 'struct');
- return $this->xmlrpc->send_response($response);
-
Data Types
==========
@@ -536,3 +451,118 @@
- *struct* (contains array of values)
- *array* (contains array of values)
+***************
+Class Reference
+***************
+
+.. class:: CI_Xmlrpc
+
+ .. method:: initialize([$config = array()])
+
+ :param array $config: configuration data
+ :returns: void
+
+ Initializes the XML-RPC library. Accepts an associative array containing your settings.
+
+ .. method:: server($url[, $port = 80[, $proxy = FALSE[, $proxy_port = 8080]]])
+
+ :param string $url: XML-RPC server URL
+ :param int $port: server port
+ :param string $proxy: optional proxy
+ :param int $proxy_port: proxy listening port
+ :returns: void
+
+ Sets the URL and port number of the server to which a request is to be sent::
+
+ $this->xmlrpc->server('http://www.sometimes.com/pings.php', 80);
+
+ .. method:: timeout($seconds = 5)
+
+ :param int $seconds: timeout in seconds
+ :returns: void
+
+ Set a time out period (in seconds) after which the request will be canceled::
+
+ $this->xmlrpc->timeout(6);
+
+ .. method:: method($function)
+
+ :param string $function: method name
+ :returns: void
+
+ Sets the method that will be requested from the XML-RPC server::
+
+ $this->xmlrpc->method('method');
+
+ Where method is the name of the method.
+
+ .. method:: request($incoming)
+
+ :param array $incoming: request data
+ :returns: void
+
+ Takes an array of data and builds request to be sent to XML-RPC server::
+
+ $request = array(array('My Photoblog', 'string'), 'http://www.yoursite.com/photoblog/');
+ $this->xmlrpc->request($request);
+
+ .. method:: send_request()
+
+ :returns: bool
+
+ The request sending method. Returns boolean TRUE or FALSE based on success for failure, enabling it to be used conditionally.
+
+ .. method set_debug($flag = TRUE)
+
+ :param bool $flag: debug status flag
+ :returns: void
+
+ Enables or disables debugging, which will display a variety of information and error data helpful during development.
+
+ .. method:: display_error()
+
+ :returns: string
+
+ Returns an error message as a string if your request failed for some reason.
+ ::
+
+ echo $this->xmlrpc->display_error();
+
+ .. method:: display_response()
+
+ :returns: mixed
+
+ Returns the response from the remote server once request is received. The response will typically be an associative array.
+ ::
+
+ $this->xmlrpc->display_response();
+
+ .. method:: send_error_message($number, $message)
+
+ :param int $number: error number
+ :param string $message: error message
+ :returns: object
+
+ This method lets you send an error message from your server to the client.
+ First parameter is the error number while the second parameter is the error message.
+ ::
+
+ return $this->xmlrpc->send_error_message(123, 'Requested data not available');
+
+ .. method send_response($response)
+
+ :param array $response: response data
+ :returns: object
+
+ Lets you send the response from your server to the client. An array of valid data values must be sent with this method.
+ ::
+
+ $response = array(
+ array(
+ 'flerror' => array(FALSE, 'boolean'),
+ 'message' => "Thanks for the ping!"
+ ),
+ 'struct'
+ );
+
+ return $this->xmlrpc->send_response($response);
\ No newline at end of file