README
1$Id: README,v 1.1.1.1 2003/03/20 17:05:13 mah Exp $
2
3--------
4Abstract
5--------
6
7POE::Component::Server::XMLRPC adds asynchronous, event driven
8XMLRPC over HTTP to your POE applications. It works very well
9with synchronous XMLRPC::Lite clients, even.
10
11-------
12Example
13-------
14
15The example/ping-server script is a "personal ping proxy"
16<http://philringnalda.com/blog/2003/03/allnewer_fast_again_weblogscom.php>
17which takes a ping in the form needed by Weblogs.com and sends it
18out to a list of ping servers. This saves you the trouble and
19aggrevation of pinging multiple servers. Updates to the script
20can be found at <http://openweblog.info/>.
21
22------------
23Requirements
24------------
25
26POE::Component::Server::XMLRPC requires the following modules,
27each of which probably has its own requirements.
28
29 POE::Component::Server::HTTP
30 XMLRPC::Lite
31
32It is recommended to use some installation utility such as CPANPLUS,
33CPAN, or ActiveState's PPM to ensure that dependencies are included.
34
35------------------
36Basic Installation
37------------------
38
39POE::Component::Server::XMLRPC may be installed through the CPAN shell
40in the usual CPAN shell manner. This typically is:
41
42 $ perl -MCPAN -e 'intstall POE::Component::Server::XMLRPC'
43
44You can also read this README from the CPAN shell:
45
46 $ perl -MCPAN -e shell
47 cpan> readme POE::Component::Server::XMLRPC
48
49And you can install the component from the CPAN prompt as well:
50
51 cpan> install POE::Component::Server::XMLRPC
52
53-------------------
54Manual Installation
55-------------------
56
57This component may also be installed manually.
58<ftp://ftp.cpan.org/pub/CPAN/authors/id/M/MA/MAHEX/> or a
59similarly named directory at your favorite CPAN mirror should
60hold the latest version.
61
62Downloading and unpacking the distribution are left as exercises for
63the reader. To build and test it:
64
65 perl Makefile.PL
66 make test
67
68When you're ready to install the component:
69
70 make install
71
72Now it should be ready to use.
73
74Thanks for reading!
75
76-- Mark A. Hershberger <mah@everybody.org>
77 (This README is a slightly editted verison of the one included
78 in POE::Component::Server::XMLRPC.)
79