#
# 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 ([email protected])
Byrne Reese ([email protected])

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.