DISTRIBUTION NOTES

To install gSOAP, unpack the archive. You will get the following files:

README.txt	read this first
NOTES.txt	this file
bin/soapcpp2	executable gSOAP 2 compiler
bin/wsdl2h	executable gSOAP WSDL parser
doc/index.html	documentation
changelog.html	changes
license.html	gSOAP public license (HTML)
license.pdf	gSOAP public license (PDF)
gpl.txt		GPL license
soapdoc2.html	documentation (HTML)
soapdoc2.pdf	documentation (PDF)
stdsoap2.h	header file for stdsoap2.c[pp]
stdsoap2.c	library and gSOAP runtime
stdsoap2.cpp	library (identical to stdsoap2.c)
dom.html	gSOAP DOM parser (HTML)
dom.pdf		gSOAP DOM parser (PDF)
dom.h		header file for dom.c
dom.c		C DOM parser
dom.cpp		C++ DOM parser
typemap.dat	XML schema to C/C++ type mapper for wsdl2h WSDL parser

... and the following subdirectories:

bin		binaries
doc		documentation
samples		examples
extras		(contributed) extras
import		#import-ed header files for soapcpp2 compiler
plugin		plug-in examples
custom		custom serializers for various data types
mod_gsoap	Apache mod_gsoap, IIS, and WinInet support
src		gSOAP compiler sources
wsdl		WSDL parser sources

Examples are included in the 'samples' subdirectory. The examples are:

DIRECTORY			DESCRIPTION
calc:				Simple calculator client and server
ck:				HTTP cookie client and server
components/c, components/cpp:	Multiple clients/services in one executable
dime:				DIME attachment client and server
events:				Asynchronous one-way messaging
factory:			Remote object factory and simple ORB
factorytest:			Test client for remote object factory
googleapi:			Google Web API client
listing:			XMethod service listing client
localtime:			Get localtime client
lu:				Linear solver client and server
magic:				Magic Squares client and server
mtom:				MTOM attachment client and server
mtom-stream:			Streaming MTOM attachment client and server
oneliners:			Several one-liner clients and services
polytest:			Polymorphic object exchange
quote:				Get delayed stock quote
quote2:				Get delayed stock quote (SOAP async messages)
quote3:				Get delayed stock quote (with Stock class)
quote4:				Get delayed stock quote (using XML DOM)
quotex:				Combined client/server example in one
router:				Router of HTTP messages over TCP/IP
rss:				RSS 0.91, 0.92, and 2.0 server
ssl:				HTTPS/SSL example (requires OpenSSL)
udp:				SOAP-over-UDP example client and server
varparam:			Variable polymorphic parameters client/server
webserver:			Stand-alone Web server with a lot of features
wsa:				WS-Addressing demo
wsse:				WS-Security demo
xml-rpc:			XML-RPC support

To build the example services and clients, type "make" in the 'samples'
directory. See also http://www.cs.fsu.edu/~engelen/soapexamples.html for
details and explanations for some of these examples.

For Windows users, the archive includes 'magic_VC' and 'quote_VC' Visual
Studio projects in the 'samples' directory.

For Mac users, the archive includes a 'quote_MAC_ProjBuild' Project Builder
example in the 'samples' directory.

To try the SSL-secure SOAP server, install OpenSSL and change the occurrences
of "linprog2.cs.fsu.edu" in sslclient.c and sslserver.c to the machine name
(or machine IP) you are using. Example .pem files are included but you need to
create your own .pem files (see OpenSSL documentation).

The sslclient and sslserver codes can then be build as follows:

soapcpp2 -c ssl.h
gcc -DWITH_OPENSSL -o sslclient sslclient.c stdsoap2.c soapC.c soapClient.c -lssl -lcrypto
gcc -DWITH_OPENSSL -o sslserver sslserver.c stdsoap2.c soapC.c soapServer.c -lssl -lcrypto -lpthread

The 'gsoap_mod' directory includes Apache 1.x and 2.0 mods for gSOAP, IIS, and
WinInet support. WinInet allows gsoap to use the WinInet API instead of calls
to the socket API. The primary benefit of this arrangement is that "if IE
works, your program will work". There is no need to read proxy settings from
the registry, deal with proxy configuration scripts, etc. Changes in the
"Internet Options" dialog box will immediately take effect in your program.
Additionally, this will allow gsoap to handle forms of authentication not yet
supported natively, such as NTLM (Integrated Windows Authentication), etc.

Contributions are included in the 'extras' directory:

ckdb.h ckdb.c:
HTTP cookie database load and store operations for persistant cookie support.
Cookies are saved in XML format using gSOAP's serializers.

ckdbtest.h ckdbtest.c:
Test client program for cookie database.

soapdefs.h logging.cpp:
C++ message logging with streams.

DISCLAIMER: WE TRY OUR BEST TO PROVIDE YOU WITH "REAL-WORLD" EXAMPLES BUT WE
CANNOT GUARANTEE THAT ALL CLIENT EXAMPLES CAN CONNECT TO THIRD PARTY WEB
SERVICES WHEN THESE SERVICES ARE DOWN OR HAVE BEEN REMOVED.