Updated version, ready for re-publication!

LDP/howto/docbook/XML-RPC-HOWTO.xml

@@ -56,7 +56,7 @@
   <articleinfo>
     <title>XML-RPC HOWTO</title>
     
-    <pubdate>0.6.0, 2001-02-02</pubdate>
+    <pubdate>0.8.0, 2001-04-12</pubdate>
     
     <authorgroup>
       <author>
@@ -89,6 +89,17 @@
     &legal.notice;
 
     <revhistory>
+      <revision>
+	<revnumber>0.8.0</revnumber>
+	<date>2001-04-12</date>
+	<revremark>Updated section on common interfaces.  Added pointer to
+	XML-RPC.Net information.</revremark>
+      </revision>
+      <revision>
+	<revnumber>0.7.0</revnumber>
+	<date>2001-04-03</date>
+	<revremark>Added section on C++ proxy classes.</revremark>
+      </revision>
       <revision>
 	<revnumber>0.6.0</revnumber>
 	<date>2001-02-02</date>
@@ -329,7 +340,9 @@ python> server.examples.getStateName(41)
     <section id="xmlrpc-howto-api-introspection">
       <title>Introspection: Discovering Server APIs</title>
 
-      <para>Edd Dumbill proposed the following set of methods:</para>
+      <para>Edd Dumbill <ulink
+      url="http://xmlrpc.usefulinc.com/doc/reserved.html">proposed</ulink>
+      the following set of methods:</para>
 
       <synopsis><returnvalue>array</returnvalue> <function>system.listMethods</function> ()
 <returnvalue>string</returnvalue> <function>system.methodHelp</function> (<type>string</type> <parameter>methodName</parameter>)
@@ -345,8 +358,17 @@ for method in server.system.listMethods():
     print server.system.methodHelp(method)
     print</programlisting>
 
-      <para>These methods are currently supported by servers written in PHP
-      and C. Please feel free to implement them for other languages!</para>
+      <para>These methods are currently supported by servers written in
+      PHP, C and Microsoft .NET.  Partial introspection support is included
+      in recent updates to UserLand Frontier.  Introspection support for
+      Perl, Python and Java is available at the <ulink
+      url="http://xmlrpc-c.sourceforge.net/hacks.php">XML-RPC
+      Hacks</ulink> page.  Please feel free to add introspection support to
+      other XML-RPC servers!</para>
+
+      <para>Various client-side tools (documentation generators, wrapper
+      generators, and so on) can be found at the XML-RPC Hacks page as
+      well.</para>
     </section>
 
     <section id="xmlrpc-howto-api-boxcarring">
@@ -363,8 +385,11 @@ for method in server.system.listMethods():
       url="http://www.xmlrpc.com/discuss/msgReader$1208">system.multicall
       RFC</ulink>.</para>
 
-      <para>This method is currently supported by servers written in C, but
-      it's easy to implement for other languages.</para>
+      <para>This method is currently supported by servers written in C and
+      UserLand Frontier.  Servers written in Python and Perl can use the
+      code at the <ulink
+      url="http://xmlrpc-c.sourceforge.net/hacks.php">XML-RPC
+      Hacks</ulink> page.</para>
     </section>
   </section>
 
@@ -749,6 +774,24 @@ bash$ c++ $CLIENT_CFLAGS -o getSumAndDifference2 getSumAndDifference2.cc $CLIENT
 
     </section>
 
+    <section id="xmlrpc-howto-cc-proxy">
+      <title>A C++ Client with Proxy Classes</title>
+
+      <para>If your XML-RPC server supports the <link
+      linkend="xmlrpc-howto-api-introspection">Introspection API</link>,
+      you can automatically generate C++ proxy classes for it.  To generate
+      a proxy class, type the following command and save the output to a
+      file:</para>
+
+      <programlisting>bash$ xml-rpc-api2cpp \
+> http://xmlrpc-c.sourceforge.net/api/sample.php sample SampleProxy</programlisting>
+
+      <para>This will generate a proxy class named
+      <literal>SampleProxy</literal> containing wrappers for all the
+      methods beginning with <literal>sample</literal>. You can edit this
+      class in any fashion you'd like.</para>
+    </section>
+
     <section id="xmlrpc-howto-c-cgi">
       <title>A CGI-Based C Server</title>
 
@@ -1013,6 +1056,18 @@ new xmlrpc_server(array('sample.sumAndDifference' =>
     </section>
   </section>
 
+  <section id="xmlrpc-howto-dotnet">
+    <title>Using XML-RPC with Microsoft .NET</title>
+
+    <para>Charles Cook is writing an excellent new chapter for this HOWTO.
+    You can find <ulink
+    url="http://www.cookcomputing.com/misc/howto.txt">a draft
+    online</ulink>.  If that page disappears, look for a <ulink
+    url="http://www.linuxdoc.org/HOWTO/XML-RPC-HOWTO/index.html">new
+    version of the XML-RPC HOWTO</ulink> at the Linux Documentation
+    Project.</para>
+  </section>
+
   <section id="xmlrpc-howto-ruby">
     <title>Using XML-RPC with Ruby</title>