#
# Filename: README
#
# $Id: README,v 1.3 2004/10/26 15:26:47 byrnereese Exp $

SOAP::Lite for Perl is a collection of Perl modules which provides a simple 
and lightweight interface to the Simple Object Access Protocol (SOAP) both 
on client and server side. 

This version of SOAP::Lite supports a subset of the SOAP 1.1 specification
and has initial support for SOAP 1.2 specification.
See http://www.w3.org/TR/SOAP for details. 

SUPPORTED PLATFORMS

This library has been tested by the author with Perl versions 5.005 
and 5.6.0 on different platforms: Windows 98/2K, Solaris 2.6, Linux 2.2. 
Should run everywhere where Perl 5.004 or later runs.

PREREQUISITES

Some modules within this package depend on other packages that are
distributed separately from Perl. It supposes that you have the
following distributions installed before you install SOAP::Lite:

  XML::Parser
  MIME::Base64                                  
  URI
  libwww-perl

Following modules will be loaded on demand only, and are considered optional:

  Crypt::SSLeay     HTTPS/SSL support
  Apache            mod_perl server implementation (included with mod_perl) 
  Net::POP3         POP3 server implementation
  MIME::Lite        SMTP client implementation
  IO::File          FTP client and IO server
  Net::FTP          FTP client
  MQSeries          MQSeries transport
  Net::Jabber       Jabber transport
  FCGI              FastCGI server implementation
  IO::Socket::SSL   SSL support for TCP transport
  MIME::Tools       MIME attachment support
  DIME::Tools       DIME attachment support
  Compress::Zlib    HTTP compression support

These modules should be available from CPAN (http://search.cpan.org/).

INSTALLATION ON UNIX

You install SOAP::Lite as you would install any perl module library,
by running these commands:

If you have CPAN.pm installed and are connected to the Internet

   > perl -MCPAN -e 'install SOAP::Lite'

From the command line, try the following:

   > perl Makefile.PL
   > make
   > make test
   > make install

INSTALLATION ON WIN32 PLATFORMS

   > perl Makefile.PL
   > nmake
   > nmake test
   > nmake install

ACTIVESTATE USERS

It is important that the same version of Perl is used to build the module, as
used to run the module. Otherwise, you may experience page faults in some
instances. Some people have found the following thread helpful in resolving
this:

http://groups.yahoo.com/group/soaplite/message/1371.

If this does not help, you may consider trying the following:

Build Lite.dll and perlapp using the same distribution. You can build Lite.dll
using the make-com-minimal and make-com-standalone batch files (found in 
the "examples/COM/" directory of the SOAP-Lite distribution package).

DOCUMENTATION

See lib/SOAP/Lite.pm for an overview of the library. Documentation is 
included in modules and scripts. These are normally converted to manual 
pages and installed as part of the "make install" process.  You should 
also be able to use the 'perldoc' utility to extract and read 
documentation from the module files directly.

SUPPORT

Questions about how to use this library should be directed to the SOAP 
mailing list (http://discuss.develop.com/soap.html). Bug reports and 
suggestions for improvements can also be sent there. This mailing list is 
also the place for general discussions and development of the SOAP protocol 
itself. 

Feel free to send mail directly to author with your comments, suggestions, 
bug reports and complaints. 

CHANGE HISTORY and RELEASE NOTES

For extensive list of changes to the SOAP::Lite module consult the "Changes"
file.

Also, consult ReleaseNotes.txt for a list of known issues and common problems
people have reported.

ACKNOWLEDGEMENTS

Special thanks to Randy J. Ray, author of I<Programming Web Services with Perl>,
who has contributed greatly to the documentation effort of SOAP::Lite.

Special thanks to O'Reilly publishing which has graciously allowed SOAP::Lite 
to republish and redistribute the SOAP::Lite reference manual found in Appendix B 
of I<Programming Web Services with Perl>.

And special gratitude to all the developers who have contributed patches, ideas,
time, energy, and help in a million different forms to the development of this
software.

COPYRIGHT

Copyright (C) 2000-2004 Paul Kulchenko. All rights reserved.

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

SOAP::Lite's documentation is made available under the Creative Commons
Attribution-NoDerivs 2.0 license.
http://creativecommons.org/licenses/by-nd/2.0/

AUTHORS

Paul Kulchenko (paulclinger@yahoo.com)
Byrne Reese (byrne@majordojo.com)