ADAMSNAMES XMLRPC TOY CLIENTS
                 =================================

This is free software, you may use it and distribute it under the
same terms as Perl itself.

NOTE: This is NOT production quality code. Rather it illustrates how
to talk to the XMLRPC API at AdamsNames

PREREQUISITES:

Besides perl you'll need Paul Kulchenko's XMLRPC::Lite. You can get
this from CPAN (http://www.cpan.org/).

To check is this software is properly installed try this:

	perl -w -MXMLRPC::Lite -e 'print "OK\n";'

Rather than use it directly, the software makes use of the AN_XMLRPC
class which wraps XMLRPC::Lite and provides implicit logging of
method calls and their return values.

If you run the contacts from the directory in which you unpack them
then they should find the AN_XMLRPC.pm file without problems.

THE CLIENTS:

We suggest you look at the clients in the following order:

	domquery.pl
	conquery.pl
	conreg.pl
	conedit.pl
	domreg.pl
	domedit.pl

This is simply because, for example, anything registering a domain
needs first to register a contact, so it makes sense to look at the
client which registers contacts first.

COMMAND LINE ARGUMENTS:

All the clients should work without special arguments.

POINTS OF CONTACT:

Documentation for the XMLRPC API can be found online at 
http://www.adamsnames.com/api/xmlrpc.html

If you'd like to contact us, please email person2007@adamsnames.com.