[sr-dev] git:master: mi_xmlrpc: added note about using xmlrpc as better alternative

[Daniel-Constantin Mierla]

Module: sip-router
Branch: master
Commit: 67d11b26dd6740ac8704c601ccfa69cfe27e5517
URL:    http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=67d11b26dd6740ac8704c601ccfa69cfe27e5517

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date:   Wed Mar 14 09:51:43 2012 +0100

mi_xmlrpc: added note about using xmlrpc as better alternative

- no dependency on specific external lib versions

---

 modules_k/mi_xmlrpc/README                  |   22 ++++++++++++++--------
 modules_k/mi_xmlrpc/doc/mi_xmlrpc_admin.xml |    7 +++++++
 2 files changed, 21 insertions(+), 8 deletions(-)

diff --git a/modules_k/mi_xmlrpc/README b/modules_k/mi_xmlrpc/README
index a74cb06..27eddbd 100644
--- a/modules_k/mi_xmlrpc/README
+++ b/modules_k/mi_xmlrpc/README
@@ -12,7 +12,7 @@ Edited by
 
 Juha Heinanen
 
-   Copyright © 2006 Voice Sistem SRL
+   Copyright © 2006 Voice Sistem SRL
      __________________________________________________________________
 
    Table of Contents
@@ -67,6 +67,13 @@ Chapter 1. Admin Guide
 
 1. Overview
 
+   NOTE: this module depends on specific versions of libxmlrpc-c3, which
+   may not be available on your OS. You better use the 'xmlrpc' module
+   located in 'modules/' folder. It can run any MI command by loading
+   'mi_rpc' module and executing RPC command 'mi', with first parameter
+   being the MI command, then followed by other parameters that will be
+   passed to the MI command.
+
    This module implements a xmlrpc server that handles xmlrpc requests and
    generates xmlrpc responses. When a xmlrpc message is received a default
    method is executed.
@@ -108,14 +115,13 @@ Chapter 1. Admin Guide
    The following libraries or applications must be installed before
    running Kamailio with this module loaded:
      * libxml.
-     * libxmlrpc-c3 version 0.9.10.
-     * libxmlrpc-c3-dev version 0.9.10.
+     * libxmlrpc-c3 version 0.9.10 or version 1.06.[10-30].
+     * libxmlrpc-c3-dev version 0.9.10 or version 1.06.[10-30].
 
    If libxmlrpc-c3[-dev] package is not available on your system, you may
    check if packages for your OS are not available on the
-   “xmlrpc-c”project ( http://xmlrpc-c.sourceforge.net/). Otherwise you
-   need to install the library and devel headers from the sources. In both
-   cases, keep in mind to use the 0.9.10 version!!.
+   "xmlrpc-c"project ( http://xmlrpc-c.sourceforge.net/). Otherwise you
+   need to install the library and devel headers from the sources.
 
 4. Parameters
 
@@ -184,8 +190,8 @@ modparam("mi_xmlrpc", "buffer_size", 8192)
 
 6. Example
 
-   This is an example showing the xmlrpc format for the “get_statistics
-   dialog: tm:” MI commad: response.
+   This is an example showing the xmlrpc format for the "get_statistics
+   dialog: tm:" MI commad: response.
 
    Example 1.5. XMLRPC request
 POST /RPC2 HTTP/1.0
diff --git a/modules_k/mi_xmlrpc/doc/mi_xmlrpc_admin.xml b/modules_k/mi_xmlrpc/doc/mi_xmlrpc_admin.xml
index f0d7988..dd23798 100644
--- a/modules_k/mi_xmlrpc/doc/mi_xmlrpc_admin.xml
+++ b/modules_k/mi_xmlrpc/doc/mi_xmlrpc_admin.xml
@@ -16,6 +16,13 @@
 	<section>
 	<title>Overview</title>
 	<para>
+		NOTE: this module depends on specific versions of libxmlrpc-c3, which may
+		not be available on your OS. You better use the 'xmlrpc' module located in
+		'modules/' folder. It can run any MI command by loading 'mi_rpc' module and
+		executing RPC command 'mi', with first parameter being the MI command,
+		then followed by other parameters that will be passed to the MI command.
+	</para>
+	<para>
 		This module implements a xmlrpc server that handles xmlrpc requests and
 		generates xmlrpc responses. When a xmlrpc message is received a default 
 		method is executed.