RELEASE_en.html

Revision 948, 48.6 kB (checked in by nahi, 5 years ago)
Modify CSS a little.
Property svn:eol-style set to `native` Property svn:executable set to ``* Property svn:keywords set to `author date id revision`

Line
1	<?xml version="1.0"?>
2	<!DOCTYPE html
3	PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
4	"DTD/xhtml1-strict.dtd">
5	<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
6	<head>
7	<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
8	<meta http-equiv="Content-Style-Type" content="text/css" />
9	<link rev="MADE" href="mailto:nakahiro@sarion.co.jp" />
10	<link rel="StyleSheet" href="rubyStyle.css" type="text/css" media="screen" />
11	<title>Release Notes - SOAP4R</title>
12	</head>
13	<body>
14
15	<div class="header">
16	<h1>
17	Release Notes - SOAP4R
18	</h1>
19
20	<p class="status">
21	Last modified: September 13, 2003<br />
22	Created: July 17, 2000
23	</p>
24	</div>
25
26	<hr />
27
28	<div class="main">
29	<h2><span class="content">0. In this document...</span></h2>
30
31	<p>
32	This is Release Notes of SOAP4R.
33	</p>
34
35	<p>
36	Target SOAP4R version: SOAP4R/1.5.0
37	</p>
38
39	<ol>
40	<li><a href="#changes">Changes</a></li>
41	<li><a href="#install">Install</a></li>
42	<li><a href="#uninstall">Uninstall</a></li>
43	<li><a href="#whats">What is SOAP4R?</a></li>
44	<li><a href="#dependencies">Dependencies</a></li>
45	<li><a href="#samples">Samples</a></li>
46	<li><a href="#restrictions">Restrictions</a></li>
47	<li><a href="#resources">Resources</a></li>
48	<li><a href="#history">History</a></li>
49	<li><a href="#author">Author</a></li>
50	<li><a href="#copyright">Copyright</a></li>
51	</ol>
52
53	<h2 id="changes" name="changes"><span class="content">1. Changes</span></h2>
54
55	<p>
56	Thousands of lines are changed in this release
57	(*.rb in current SOAP4R distribution has 30kloc or over).
58	But the biggest change is coding convention, camelCase to non_camel_case.
59	Though I tried to keep compatibility between 1.5.0 and 1.4.8, but there's no
60	way to keep it at a few point. If you'll find your code which was developed
61	for 1.4.8 does not run under 1.5.0, feel free to ask
62	<a href="mailto:nakahiro@sarion.co.jp">me</a> to solve the problem.
63	</p>
64	<ul>
65	<li>Dependency libraries;
66	<ul>
67	<li>Add net/http support. Users can try sample SOAP clients without installing http-access2. For actual usage, consider installing http-access2 for speed and thread-safe SOAP client. CAUTION: Building SOAP CGI server needs http-access2 to be installed.</li>
68	<li>Soap4r standalone server requires webrick module to be installed instead of GServer.rb and httpserver.rb.</li>
69	<li>Supports iconv. To use utf-8, you need to install iconv(included in ruby/1.8) or uconv.</li>
70	<li>Suspend NQXML XML parser support.</li>
71	<li>Remove REXML processor version check. No longer needed.</li>
72	<li>Rewrite tests with test/unit.</li>
73	</ul></li>
74
75	<li>Features;
76	<ul>
77	<li>Efforts to support messaging with document/literal and ASP.NET interoperability.</li>
78	<li>Add document/literal messaging interface to wsdlDriver.rb. See a very brief example in sample/soapbox/wsdlDriver.rb though I still didn't try to login to Jabber server.. Jabber folks?</li>
79	<li>XML pretty printing.</li>
80	<li>Better Ruby object mapping. Rewrote RubytypeFactory to support more Ruby objects. Tests in AMarshal(http://cvs.m17n.org/~akr/amarshal/) much helped it. Thanks very much to Tanaka Akira-san.</li>
81	<li>SOAPMarshal accepts IO as an output device like Marshal#dump.</li>
82	<li>SOAPElement: constructor signature change. Added extraattrs attribute.</li>
83	<li>XSDDateTimeImpl: to_time did not set usec.</li>
84	<li>StreamHandler: add reset method to shutdown a connection to a site.</li>
85	</ul></li>
86
87	<li>Others;
88	<ul>
89	<li>Simplify installer and remove uninstaller. Saving inventory file in src dir could be the problem.</li>
90	<li>Class/Module architecture relocation.</li>
91	<li>Changing coding convention to fit with Ruby's. Added lib/soap/compat.rb which defines compatibility definitions for 1.4.8. lib/soap/compat.rb warns when the library is loaded.</li>
92	<li>Many warnings raised under 1.8, caused by illegal references like XSD::XSDInt in typeMap.rb. Soap4r defined toplevel::XSDInt. Define XSD* classes in XSD module and introduce it to toplevel.</li>
93	</ul></li>
94	</ul>
95
96	<p>
97	Thanks to all of soap4r users for their support.
98	</p>
99
100	<h2 id="install" name="install"><span class="content">2. Install</span></h2>
101
102	<p>
103	At first, see <a href="#dependencies">Dependencies</a> section.
104	You may need to install some extra packages.
105	Next, get the archived file of SOAP4R and extract it, then simply try;
106	</p>
107	<pre class="path">
108	$ ruby install.rb
109	</pre>
110
111	<p>
112	Necessary files will be installed to suitable directory.
113	</p>
114
115	<p>
116	Files in lib/soap directory are SOAP4R library program itself.
117	</p>
118
119	<dl>
120	<dt class="path">lib/</dt>
121	<dd>Libraries.</dd>
122
123	<dt class="path">sample/</dt>
124	<dd>SOAP4R samples.
125	See <a href="#samples">Samples</a> section.</dd>
126
127	<dt class="path">test/</dt>
128	<dd>Some tests.
129	Unit test MUST cover all lines of code, but far from enough so far...
130	<br/>
131	test/interopR2/ directory includes Clients/Server for
132	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
133	Followings are advanced examples to use complex type transmit,
134	sending base64 encoded string, multi-dimensional array, and so on.
135	<ul>
136	<li>test/interopR2/server.rb is a RPC Server side implementation.</li>
137	<li>test/interopR2/client.rb is a RPC Client side implementation.</li>
138	<li>test/interopR2/base.rb includes common definitions for client/server.</li>
139	</ul>
140	</dd>
141	</dl>
142
143	<h2 id="uninstall" name="uninstall"><span class="content">3. Uninstall</span></h2>
144
145	<p>
146	Simply delete installed files.
147	</p>
148
149	<h2 id="whats" name="whats"><span class="content">4. What is SOAP4R?</span></h2>
150
151	<p>
152	'SOAP4R' is an implementation of
153	<a href="http://www.w3.org/TR/SOAP/">Simple Object Access Protocol (SOAP) 1.1 (W3C Note)</a>.
154	</p>
155
156	<p>
157	Comments, information such as interoperability between SOAP4R and another implementation are welcomed.
158	Feel free sending mail to
159	<a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a>.
160	</p>
161
162	<h2 id="dependencies" name="dependencies"><span class="content">5. Dependencies</span></h2>
163
164	<p>
165	SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and
166	aims to use with Ruby application.
167	You have to install Ruby itself.
168	Ruby/1.6 series or later is required.
169	It does not works on 1.4 series because it does not have class variable.
170	</p>
171
172	<p>
173	SOAP4R depends on following Ruby modules in
174	<a href="http://raa.ruby-lang.org">RAA</a>.
175	You also have to install these modules to use SOAP4R.
176	</p>
177
178	<dl>
179	<dt class="path">XML processor</dt>
180	<dd>SOAP4R requires a XML processor package installed.
181	For now, one of following XML processor must be installed
182	(SOAP4R automatically detects it in runtime).
183	FYI: xmlscan and REXML are scheduled to be included in ruby/1.8's standard
184	distribution. Version following each project is the version tested with soap4r.
185	<br/>
186	Note: ruby/1.8 includes REXML so you don't have to install extra XML parser library.
187	<ul>
188	<li><a href="http://raa.ruby-lang.org/list.rhtml?name=xmlscan">[RAA:xmlscan]</a> (0.2.3, 0.3.x)</li>
189	<li><a href="http://raa.ruby-lang.org/list.rhtml?name=rexml">[RAA:REXML]</a> (2.7.1)</li>
190	<li><a href="http://raa.ruby-lang.org/list.rhtml?name=rexml-stable">[RAA:REXML-stable]</a> (2.4.8)</li>
191	<li><a href="http://raa.ruby-lang.org/list.rhtml?name=xmlparser">[RAA:XMLParser]</a> (0.6.5)</li>
192	</ul></dd>
193
194	<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=devel-logger">[RAA:devel-logger]</a> (1.1.0)</dt>
195	<dd>Logging utility by NaHi.</dd>
196
197	<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=webrick">[RAA:webrick]</a> (1.3.1) (required for soap server)</dt>
198	<dd>TCP server toolkit by Gotoyuzo.
199	ruby/1.8 includes WEBrick in standard distribution library.</dd>
200
201	<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=http-access2">[RAA:http-access2]</a> (2.0.0) (required for SOAP CGI server, recommended for SOAP client)</dt>
202	<dd>Yet another HTTP client implementation by NaHi.</dd>
203
204	<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=date2">[RAA:date2]</a> (3.2) (required under ruby/1.6)</dt>
205	<dd>Date and DateTime implementation by Todayoshi Funaba.
206	Note: From ruby/1.8, this module is included in standard distribution.
207	You don't have to install it if you are using ruby/1.8 or later.</dd>
208
209	<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=uconv">[RAA:uconv]</a> (0.4.10) (required for UTF-8 handling under ruby/1.6)</dt>
210	<dd>by Yoshida Masato.
211	It is requred when you use ruby/1.6 and want automatic CES conversion between
212	SJIS <-> UTF8 and EUC <-> UTF8.
213	Under ruby/1.8, soap4r uses iconv in standard distribution library.
214	Note: SJIS <-> EUC uses NKF module which is in standard distribution.
215	I will support Iconv for more conversion set.
216	</dd>
217
218	</dl>
219
220	<h2 id="samples" name="samples"><span class="content">6. Samples</span></h2>
221
222	<p>
223	Samples are in sample/ directory of distribution.
224	Some samples try to connect to public servers.
225	Set environment variable HTTP_PROXY if you are in a firewall and you have
226	http proxy to the internet like;
227	</p>
228	<pre class="path">
229	$ export HTTP_PROXY=http://myproxyserver:8080
230	or
231	$ setenv HTTP_PROXY http://myproxyserver:8080
232	</pre>
233
234	<dl>
235	<dt class="path">babelfish.rb</dt>
236	<dd>A client for
237	<a href="http://www.xmethods.com/ve2/ViewListing.po?serviceid=14">BabelFish</a>
238	which namespace URI is 'urn:xmethodsBabelFish'.
239	<pre class="path">
240	$ ./babelfish.rb "Text to translate" [ translation pattern like 'en_fr' ]
241	</pre>
242	</dd>
243
244	<dt class="path">whois.rb</dt>
245	<dd>A client for
246	<a href="http://www.xmethods.com/ve2/ViewListing.po?serviceid=34">SQLData's WHOIS</a>
247	which namespace URI is 'http://www.SoapClient.com/xml/SQLDataSoap.xsd'.
248	<pre class="path">
249	$ ./whois.rb ruby-lang.org
250	</pre>
251	CAUTION: This WhoIs server does not handle non-ascii characters correctly.
252	Querying domain which entry contains Japanese or so will hang. Gee.
253	</dd>
254
255	<dt class="path">digraph.rb</dt>
256	<dd>A sample of SOAP marshalling/unmarshalling.
257	It creates a digraph that contains multi-ref-ed nodes at first
258	and marshals this object to get serialized XML instance.
259	Then reads and unmarshals this XML instance to recover a object
260	which has the same links among nodes in the digraph.
261	</dd>
262
263	<dt class="path">apacheClient.rb</dt>
264	<dd>SOAP-RPC client sample which connects with demonstration server;
265	stockquote and addressbook in Apache-SOAP.
266	You have to install Apache-SOAP and deploy demostration programs.<br />
267	To execute;
268	<pre class="path">
269	$ ./apacheClient.rb http://localhsot:2020/xml-soap/rpcrouter/rpcrouter.jsp
270	</pre>
271	</dd>
272
273	<dt class="path">GoogleSearch/</dt>
274	<dd>A sample client to search with <a href="http://www.google.com/apis/">Google Web API</a> using WSDL.
275	You need to get a developer's key to use it.
276	See wsdlDriver.rb.
277	</dd>
278
279	<dt class="path">Amazon/</dt>
280	<dd>A sample client to connect with <a href="http://associates.amazon.com/exec/panama/associates/ntg/browse/-/1067662/086-5207681-4585409">AmazonWebServices</a> using WSDL.
281	See wsdlDriver.rb.
282	</dd>
283
284	<dt class="path">Calc/</dt>
285	<dd>Calc service contains 2 servers and 2 clients.
286	calc.rb is hosted by server.rb, calc2.rb is hosted by server2.rb.
287	client.rb is for server.rb, client2.rb is for server2.rb.
288	<dl>
289	<dt>calc.rb</dt>
290	<dd>Calc server definition using module and module methods.
291	This module responds 'add', 'sub', 'multi' and 'div'.</dd>
292	<dt>server.rb</dt>
293	<dd>Standalone server.
294	It requires calc.rb and serve module methods of this module.
295	To run this server;
296	<pre class="path">
297	$ ./server.rb
298	</pre>
299	</dd>
300	<dt>server.cgi</dt>
301	<dd>CGI version.
302	To run this server, copy server.cgi and calc.rb to suitable directory
303	of your WWW server.
304	</dd>
305	<dt>client.rb</dt>
306	<dd>It connects to server.rb or server.cgi,
307	and hit methods served by calc.rb.
308	To run the client;
309	<pre class="path">
310	$ ./client.rb
311	</pre>
312	Is it stacked? Did you run the server.rb?<br/>
313	Turn logger and wireDumpDev in its source on to see logs and wire dumps of
314	SOAP transport.</dd>
315
316	<dt>calc2.rb</dt>
317	<dd>Calc server definition using class and instance methods.
318	An instance of this class holds its value. Methods 'set' and 'get' is to
319	set/get the value.
320	It also responds to '+', '-', '*', and '/'.
321	</dd>
322	<dt>server2.rb</dt>
323	<dd>It requires calc2.rb and creates an instance of CalcService2
324	that responds all SOAP requests.
325	Since '+', '-' and so on of calc2.rb are not valid name as an element
326	in XML instance,
327	this sample register the method '+' as 'add', '-' as 'sub', and so on.
328	</dd>
329	<dt>server2.cgi</dt>
330	<dd>CGI version.
331	To run this server, copy server2.cgi and calc2.rb to suitable directory
332	of your WWW server.
333	</dd>
334	<dt>client2.rb</dt>
335	<dd>It connects to server2.rb or server2.cgi.
336	Set a value at first and call methods like 'puts objAtServer + 2'.</dd>
337	</dl>
338	</dd>
339
340	<dt class="path">Exchange/</dt>
341	<dd>A sample to retrieve the currency rate from public SOAP service.</dd>
342	<dl>
343	<dt>iExchange.rb</dt>
344	<dd>It includes common definitions for client and server of
345	Exchange service.
346	Including only a definition of namespace URI of this service.</dd>
347	<dt>exchange.rb</dt>
348	<dd>Definition of servant class ExchangeService which returns the currency rate
349	after connecting to another site by SOAP to get the real rate.
350	So that this class is the SOAP server for local client and
351	is also a SOAP client for public server.
352	An instance of this class is hosted by server.rb.
353	The instance responds to only 'getRate' which receives two country code
354	such as 'USA' and 'Japan'.</dd>
355	<dt>server.rb</dt>
356	<dd>It requires exchange.rb and creates an instance of ExchangeService
357	that responds all SOAP requests.
358	To run this server;
359	<pre class="path">
360	$ ./server.rb
361	</pre>
362	</dd>
363	<dt>server.cgi</dt>
364	<dd>CGI version.
365	To run this server, copy server.cgi and exchange.rb to suitable directory
366	of your WWW server.
367	</dd>
368	<dt>client.rb</dt>
369	<dd>It connects to server.rb.
370	Turn logger and wireDumpDev in its source on to see logs and wire dumps of
371	SOAP transport.
372	To run the client;
373	<pre class="path">
374	$ ./client.rb
375	</pre>
376	</dd>
377	</dl>
378	</dd>
379
380	<dt class="path">SampleStruct/</dt>
381	<dd>A sample to transmit complex structured object which has recursive
382	object reference.
383	<dl>
384	<dt>iSampleStruct.rb</dt>
385	<dd>It includes common definitions for client and server of
386	SampleStruct service.
387	Definition of SampleStruct class and namespace URI of this service.</dd>
388	<dt>sampleStruct.rb</dt>
389	<dd>Definition of servant class SampleStructService.
390	An instance of this class is hosted by server.rb.
391	The instance responds to only 'hi' which receives a SampleStruct and wraps
392	it in the new instance of SampleStruct to return .</dd>
393	<dt>server.rb</dt>
394	<dd>It requires sampleStruct.rb and creates an instance of SampleStructService
395	that responds all SOAP requests.
396	To run this server;
397	<pre class="path">
398	$ ./server.rb
399	</pre>
400	</dd>
401	<dt>server.cgi</dt>
402	<dd>CGI version.
403	To run this server, copy server.cgi and sampleStruct.rb to suitable directory
404	of your WWW server.
405	</dd>
406	<dt>client.rb</dt>
407	<dd>It connects to server.rb.
408	Turn logger and wireDumpDev in its source on to see logs and wire dumps of
409	SOAP transport.
410	To run the client;
411	<pre class="path">
412	$ ./client.rb
413	</pre>
414	</dd>
415	</dl>
416	</dd>
417
418	<dt class="path">RAA/</dt>
419	<dd>SOAP-RPC client samples.
420	These programs connect to RAA SOAP Interface on www.ruby-lang.org.
421	<ul>
422	<li>soap4r.rb: Ruby program using SOAP4R</li>
423	<li>xmlrpc4r.rb: Ruby program using xmlrpc4r</li>
424	<li>pocketSOAP.js: JScript program using pocketSOAP</li>
425	<li>SOAP::Lite.pl: Perl program using SOAP::Lite for Perl</li>
426	</ul>
427	Since the server is (still) under testing phase so stable operation is not expected.</dd>
428
429	<dt class="path">webrick/</dt>
430	<dd>SOAP-RPC server samples which runs with WEBrick.
431	<ul>
432	<li>httpd.rb: HTTP server which soaplet.rb mounts to.
433	It is powered by WEBrick so you must install
434	<a href="http://raa.ruby-lang.org/list.rhtml?name=webrick">[RAA:WEBrick]</a>
435	to run it.</li>
436	<li>soaplet.rb: A bricklet to add a SOAP function to WEBrick.
437	It hosts exchange.rb, sampleStruct.rb below, and it is mounted to httpd.rb
438	to serve ExchangeService and SampleStructService.</li>
439	<li>ExchangeService
440	<dl>
441	<dt>exchange.rb</dt>
442	<dd>A server class definition which returns the currency rate
443	after connecting to another site by SOAP to get the real rate.
444	An instance of this class is instanciated in httpd.rb and this instance
445	respond to each HTTP request.</dd>
446	<dt>exchangeClient.rb</dt>
447	<dd>A client to connect soaplet.rb via SOAP/HTTP to call exchange.rb.</dd>
448	<dt>iExchange.rb</dt>
449	<dd>Common class(type) definitions for server and client.</dd>
450	</dl>
451	</li>
452
453	<li>SampleStructService
454	<dl>
455	<dt>sampleStruct.rb</dt>
456	<dd>A server class definition which wraps a given struct
457	and returns it.
458	An instance of this class is instanciated in httpd.rb and this instance
459	respond to each HTTP request.</dd>
460	<dt>sampleStructClient.rb</dt>
461	<dd>A client to connect soaplet.rb via SOAP/HTTP to call sampleStruct.rb</dd>
462	<dt>iSampleStruct.rb</dt>
463	<dd>Common class(type) definitions for server and client.</dd>
464	</dl></li>
465	</ul>
466	Run the server;
467	<pre class="path">
468	$ ruby httpd.rb
469	</pre>
470	Then, run clients;
471	<pre class="path">
472	$ ruby sampleStruct.rb
473	$ ruby exchangeClient.rb
474	</pre>
475	Set 'logger' and 'wireDumpDev' in clients to see log and wiredumps of SOAP.
476	</dd>
477
478	<dt class="path">ICD</dt>
479	<dd>A client for
480	<a href="http://www.iwebmethod.net/">Insider's Computer Dictionary Web Service</a>.
481	This service is implemented with ASP.NET so that it's also a sample of
482	a client which connects to ASP.NET.
483	CAUTION: this sample contains non-ascii chars in its source and dumped results.
484	<dl>
485	<dt>IICD.rb</dt>
486	<dd>Class(type) definitions for this server.</dd>
487	<dt>icd.rb</dt>
488	<dd>Client implementation. To run the client;
489	<pre class="path">
490	$ ./icd.rb
491	</pre>
492	</dd>
493	</dl>
494	</dd>
495
496	<dt class="path">WSDemo</dt>
497	<dd>A sample of messaging client. Server side sample does not exist now...</dd>
498
499	<dt class="path">RWiki</dt>
500	<dd>A sample CGI server which receives a request via SOAP and dispatches it
501	to RWiki server via dRuby. Naive SOAP/dRuby bridge implementation.</dd>
502
503	</dl>
504
505	<h2 id="restrictions" name="restrictions"><span class="content">7. Restrictions</span></h2>
506
507	<p>
508	The following features of the
509	<a href="http://www.w3.org/TR/SOAP/">SOAP 1.1 (W3C Note)</a>
510	spec are <strong>NOT</strong> currently supported:
511	</p>
512
513	<ul>
514	<li style="margin-top: 2ex;">SOAP Envelope
515	<ul>
516	<li>SOAP actor attribute</li>
517	<li>SOAP mustUnderstand attribute</li>
518	<li>SOAP Fault Codes</li>
519	</ul></li>
520	<li style="margin-top: 2ex;">SOAP Encoding
521	<ul>
522	<li>Decoding using XML Schema</li>
523	</ul></li>
524	<li style="margin-top: 2ex;">Othres
525	<ul>
526	<li>Transport binding except HTTP server and client</li>
527	</ul></li>
528	</ul>
529
530	<h2 id="resources" name="resources"><span class="content">8. Resources</span></h2>
531
532	<dl>
533	<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=soap4r">[RAA:soap4r]</a></dt>
534	<dd>I will post a new release to RAA.
535	Check RAA to get a new stable (I hope) version.</dd>
536
537	<dt class="path"><a href="http://www.ruby-lang.org/cgi-bin/cvsweb.cgi/lib/soap4r/">CVS</a></dt>
538	<dd>There is the SOAP4R CVS repository in cvs.ruby-lang.org.
539	(Thanks to knu, the maintainer of cvs.ruby-lang.org.)
540	Check here to get most recent (but could be unstable) version.</dd>
541
542	<dt class="path"><a href="http://rrr.jin.gr.jp/rwiki?cmd=view&name=soap4r">SOAP4R Wiki</a></dt>
543	<dd>There is a wiki for SOAP4R, running under
544	<a href="http://www.ruby-lang.org/raa/list.rhtml?name=rwiki">[RAA:RWiki]</a>.
545	Feel free to add your comment there.
546	Any comments are welcomed. (as always)</dd>
547
548	<dt class="path"><a href="http://rrr.jin.gr.jp/soap4r?cmd=view;name=InteropResults">InteropResults</a></dt>
549	<dd>Test results of <a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab "Round 2"</a>.</dd>
550
551	</dl>
552
553	<h2 id="history" name="history"><span class="content">9. History</span></h2>
554
555	<dl>
556	<dt>1.5.0 - January 17, 2003</dt>
557	<dd>Thousands of lines are changed in this release
558	(*.rb in current SOAP4R distribution has 30kloc or over).
559	But the biggest change is coding convention, camelCase to non_camel_case.
560	Though I tried to keep compatibility between 1.5.0 and 1.4.8, but there's no
561	way to keep it at a few point. If you'll find your code which was developed
562	for 1.4.8 does not run under 1.5.0, feel free to ask
563	<a href="mailto:nakahiro@sarion.co.jp">me</a> to solve the problem.
564	<ul>
565	<li>Dependency libraries;
566	<ul>
567	<li>Add net/http support. Users can try sample SOAP clients without installing http-access2. For actual usage, consider installing http-access2 for speed and thread-safe SOAP client. CAUTION: Building SOAP CGI server needs http-access2 to be installed.</li>
568	<li>Soap4r standalone server requires webrick module to be installed instead of GServer.rb and httpserver.rb.</li>
569	<li>Supports iconv. To use utf-8, you need to install iconv(included in ruby/1.8) or uconv.</li>
570	<li>Suspend NQXML XML parser support.</li>
571	<li>Remove REXML processor version check. No longer needed.</li>
572	<li>Rewrite tests with test/unit.</li>
573	</ul></li>
574
575	<li>Features;
576	<ul>
577	<li>Efforts to support messaging with document/literal and ASP.NET interoperability.</li>
578	<li>Add document/literal messaging interface to wsdlDriver.rb. See a very brief example in sample/soapbox/wsdlDriver.rb though I still didn't try to login to Jabber server.. Jabber folks?</li>
579	<li>XML pretty printing.</li>
580	<li>Better Ruby object mapping. Rewrote RubytypeFactory to support more Ruby objects. Tests in AMarshal(http://cvs.m17n.org/~akr/amarshal/) much helped it. Thanks very much to Tanaka Akira-san.</li>
581	<li>SOAPMarshal accepts IO as an output device like Marshal#dump.</li>
582	<li>SOAPElement: constructor signature change. Added extraattrs attribute.</li>
583	<li>XSDDateTimeImpl: to_time did not set usec.</li>
584	<li>StreamHandler: add reset method to shutdown a connection to a site.</li>
585	</ul></li>
586
587	<li>Others;
588	<ul>
589	<li>Simplify installer and remove uninstaller. Saving inventory file in src dir could be the problem.</li>
590	<li>Class/Module architecture relocation.</li>
591	<li>Changing coding convention to fit with Ruby's. Added lib/soap/compat.rb which defines compatibility definitions for 1.4.8. lib/soap/compat.rb warns when the library is loaded.</li>
592	<li>Many warnings raised under 1.8, caused by illegal references like XSD::XSDInt in typeMap.rb. Soap4r defined toplevel::XSDInt. Define XSD* classes in XSD module and introduce it to toplevel.</li>
593	</ul></li>
594	</ul>
595	</dd>
596
597	<dt>1.4.8 - January 17, 2003</dt>
598	<dd>
599	This version has these enhancements and bug fixes;
600	<ul>
601	<li>Avoid warnings;
602	<ul>
603	<li>Use Object#class instead of Object#type.</li>
604	<li>Avoid implicit use a String as a regexp source.</li>
605	</ul></li>
606	<li>Add wsdlDriver which reads WSDL file and allow client to call procedures. Here is an example to search Google.
607	<pre>
608	require 'soap/wsdlDriver'
609	searchWord = ARGV.shift
610	# You must get key from http://www.google.com/apis/ to use Google Web APIs.
611	key = File.open(File.expand_path("~/.google_key")).read.chomp
612	GOOGLE_WSDL = 'http://api.google.com/GoogleSearch.wsdl'
613	# Load WSDL and create driver.
614	google = SOAP::WSDLDriverFactory.new(GOOGLE_WSDL).createDriver
615	# Just invoke!
616	result = google.doGoogleSearch(key, searchWord, 0, 10, false, "", false, "", 'utf-8', 'utf-8')
617	result.resultElements.each do \|ele\|
618	puts "== #{ele.title}: #{ele.URL}"
619	puts ele.snippet
620	puts
621	end
622	</pre></li>
623	<li>WSDLDriver client examples of AmazonWebServices, RAA and RNN (Japanese Ruby blog site) are also included in sample/ dir.</li>
624	<li>Support xmlscan XML processor.</li>
625	<li>Changed XML processor detection scheme. Search xmlscan, REXML, XMLParser and NQXML in this order.</li>
626	<li>Rewrite charset handling of XML processor.
627	<ul>
628	<li>If you only use us-ascii and utf-8, all XML processors should work without uconv module.</li>
629	<li>With xmlscan/0.2 or later, you can handle euc-jp or shift_jis encoded XML instance WITHOUT uconv module.</li>
630	<li>With other XML processors includes xmlscan/0.1, you need to install uconv module to handle euc-jp or shift_jis encoded XML instance.</li>
631	</ul></li>
632	<li>cgistub.rb: Overridable response mediatype. There exists a http client which does not accept the mediatype text/xml which is specified in SOAP spec. For example, an i-Mode (smart phone) client does not accept it... You can set response mediatype to 'text/plain' for such client though it violates SOAP spec...</li>
633	<li>wsdl2ruby: Add --force option to override existing file.</li>
634	<li>Fixed many bugs.</li>
635	</ul></dd>
636
637	<dt>1.4.7 - September 20, 2002</dt>
638	<dd>
639	This version has these enhancements and bug fixes;
640	<ul>
641	<li>Includes WSDL4R initial release.
642	<ul>
643	<li>Bare in mind this is an alpha level code.
644	I wrote it halfway at half and a year ago,
645	and wrote the rest part in half and a day.
646	No comprehensive test, no strict syntax check, unfriendly error message, etc.
647	Try it if you want, and find bugs in it.</li>
648	<li>WSDL4R can run under XMLParser for now.
649	You might be able to let it run under NQXML/REXML if you know SAX
650	programming well. How XML processor is used under WSDL4R
651	is as same as under SOAP4R.</li>
652	</ul></li>
653	<li>Added xsd:short support.</li>
654	<li>::Float(double precision float in Ruby) is mapped to xsd:double now.
655	It was mapped to xsd:float.</li>
656	<li>Fixed a bug of year < 0 handling. B.C. 1 => -0001 in XMLSchema.</li>
657	<li>Fixed a bug of exception serialization. Custam mappingRegistry was not used.</li>
658	<li>Fixed a bug of regex for MediaType parsing.</li>
659	</ul>
660	</dd>
661
662	<dt>1.4.5 - May 25, 2002</dt>
663	<dd>
664	This version has these enhancements;
665	<ul>
666	<li>Supports all primitive datatypes of XML Schema Part2 Datatypes except NOTATION.
667	Added types are Duration, gYearMonth, anyURI, QName and so on.</li>
668	<li>Runs much faster than earlier versions.
669	Some performance check and tuning has been done.</li>
670	<li>Supports all Ruby objects marshalling/unmarshalling
671	except some special objects. See below for more detail.</li>
672	</ul>
673
674	CAUTION: This version requires
675	<a href="http://raa.ruby-lang.org/list.rhtml?name=date2">[RAA:date2]</a> version 3.2 or later and
676	<a href="http://raa.ruby-lang.org/list.rhtml?name=http-access2">[RAA:http-access2]</a> version F.
677	Please make sure the versions you use.
678	<br/><br/>
679
680	Here is detail of change.
681	<dl>
682	<dt>Datatypes (XMLSchemaDatatypes.rb and baseData.rb)</dt>
683	<dd>
684	<ul>
685	<li>Added duration, gYearMonth, gYear, gMonthDay, gDay, gMonth, anyURI and QName datetypes.
686	All primitive datatypes in XML Schema Part 2 section 3.2 except NOTAION are supported now.</li>
687	<li>Modified XSDDataTime, XSDDate and XSDTime implementation. These use a DataTime as a data holder.</li>
688	<li>Follow date/3.2: date2.rb -> date.rb.</li>
689	<li>Changed to_s representations of single float and double float. Thanks to gotoken.</li>
690	<li>XSDFloat: Add '0' if given str ends with 'E'. Float( "-1.4E" ) might fail on some system.</li>
691	<li>Added SOAPRawString class. Given string is embedded into XML instance directly.
692	You can use this class to embed (numeric) character references manually.</li>
693	<li>Fixed UTF8 regexp bug. XSDString uses this regexp to check a given string.</li>
694	<li>Added UT for XMLSchemaDatatypes.rb. See test/xsd_ut.rb and test/baseData_ut.rb.</li>
695	</ul></dd>
696
697	<dt>SOAP <-> Ruby object mapping (mappingRegistry.rb and rpcUtils.rb)</dt>
698	<dd>
699	<ul>
700	<li>Exception raised from server side could not be mapped to specific exception. Fixed.</li>
701	<li>Refactoring to avoid *_eval. Reduced warnings.</li>
702	<li>Added Range marshalling support.</li>
703	<li>Regexp#options support under ruby/1.6.</li>
704	<li>Supports cyclic Range such as;
705	<pre>
706	class Foo
707	attr_accessor :foo
708	def succ; end
709	def <=>( rhs ); end
710	end
711
712	o1 = Foo.new
713	o2 = Foo.new
714	r = o1..o2
715	o1.foo = r
716
717	p SOAPMarshal.load( SOAPMarshal.dump( r ))
718	</pre></li>
719	<li>Supports some instance variable of ruby standard class.
720	But instance variable of Array, Hash, String, Float and Bignum are not supported because of restriction of SOAP encoding format...</li>
721	<li>Alias ::SOAPMarshal to ::SOAP::Marshal.</li>
722	<li>Added Marshal.load and Marshal.dump as aliases to Marshal.unmarshal and
723	Marshal.unmarshal.</li>
724	</ul></dd>
725
726	<dt>misc</dt>
727	<dd>
728	<ul>
729	<li>Dumps what parser is used when $DEBUG. Try 'ruby -d -rsoap/processor -e 0'</li>
730	<li>Added CGI samples in sample/.</li>
731	<li>Some performance check and tuning has been done on both client and server side.
732	One bottle neck is Kernel.methods which SOAP4R use(d) while mapping SOAP Data Model <-> Ruby object.
733	I replaced it with Object.respond_to? .
734	Another bottle neck of client side is delegate.rb which is used by http-access2.
735	Get <a href="http://raa.ruby-lang.org/list.rhtml?name=http-access2">[RAA:http-access2]</a> version F.
736	</ul>
737	</dd>
738	</dl>
739	</dd>
740
741	<dt>1.4.4 - May 6, 2002</dt>
742	<dd>
743	This is a bug fix release.
744	Following users should update.
745	<ul>
746	<li>Users who use DateTime datatype.</li>
747	<li>Developers of SOAP client/server which works under multi-thread condition.</li>
748	<li>REXML users.</li>
749	</ul>
750	Fixed bugs.
751	<ul>
752	<li>XSDDataTime: Changed variable name usec to sec_frac. It's not a micro sec so name usec is misleading.</li>
753	<li>XSDTime: Fixed bugs in usec part.</li>
754	<li>date.rb in standard library and date2 version 3 conflicts because date2.rb is a successor of date.rb and not designed for dual use.
755	(ex. using a module which requires date.rb like DBI and another module which requires date2.rb).
756	Added a workaround for this.</li>
757	<li>SOAP::Processor was not MT-safe. Fixed.
758	Projected feature regards to MT are follows.
759	At least I hope so. Tell me if you find these wrong.
760	<ul>
761	<li>Driver: safe</li>
762	<li>Proxy: safe</li>
763	<li>Server: safe</li>
764	<li>CGIStub: safe</li>
765	<li>StandaloneServer: safe</li>
766	<li>RPCRouter: safe</li>
767	<li>StreamHandler: safe</li>
768	<li>Processor: safe</li>
769	<li>SOAPParser: unsafe</li>
770	<li>SOAPGenerator: unsafe</li>
771	<li>EncodingStyleHandler: unsafe</li>
772	</ul>
773	</li>
774	<li>SOAP4R/1.4.3 supports REXML/2.1.3 but it did not detect REXML processor automatically.</li>
775	</ul>
776	</dd>
777
778	<dt>1.4.3 - April 11, 2002</dt>
779
780	<dd>
781	<dl>
782	<dt>Attention to 1.4.2 or earlier users;</dt>
783	<dd>
784	<ul>
785	<li>Stopped redistributing packages in RAA from this release.
786	Please get <a href="#dependencies">required</a> packages from
787	<a href="http://raa.ruby-lang.org">RAA</a>
788	and install it.</li>
789	<li>It still does NOT support WSDL!</li>
790	</ul>
791	</dd>
792
793	<dt>New features</dt>
794	<dd>
795	<ul>
796	<li>Added REXML parser support.</li>
797	<li>Added uninstaller.</li>
798	<li>Re: samples
799	<ul>
800	<li>Added 3 new samples, Calc, Exchange, and SampleStruct.</li>
801	<li>Use environment variable HTTP_PROXY or http_proxy for http proxy.</li>
802	<li>Removed unreachable services.</li>
803	<li>RAA: Separate iRAA.rb into RAA.rb and iRAA.rb.</li>
804	<li>Added description about <a href="#samples">samples</a> to RELEASE_en.html.</li>
805	</ul>
806	<li>Changed String encoding handling among
807	Ruby object <-> SOAP Data Model <-> XML instance.
808	<ul>
809	<li>Ruby object: $KCODE.</li>
810	<li>SOAP Data Model: utf-8 if uconv module is installed, $KCODE if not.</li>
811	<li>XML instance: Client side use utf-8 if uconv module is installed,
812	$KCODE if not. Server side try to adjust the request encoding.</li>
813	<li>Use regexp instead of NKF.guess to check if the given String is EUC/SJIS or not.</li>
814	</ul>
815	</li>
816	<li>Added 'addServant' interface to server side. See sample/Calc/server.rb.</li>
817	<li>Added 'addMethodAs' interface to both server side and client side.
818	See sample/Calc/server2.rb.</li>
819	</ul>
820	</dd>
821
822	<dt>Changes</dt>
823	<dd>
824	<ul>
825	<li>Removed Japanese document.
826	I was tired of maintaining 2 separated documents.
827	Though my English is poor as you see, numbers of readers of my English document
828	should be more than one of my Japanese document.
829	Would you please tell me bug of my English composition and of course in the code?</li>
830	<li>Use
831	<a href="http://raa.ruby-lang.org/list.rhtml?name=devel-logger">[RAA:devel-logger]</a>
832	instead of
833	<a href="http://raa.ruby-lang.org/list.rhtml?name=application">[RAA:application]</a>.
834	</li>
835	<li>Avoided using exception in soap2obj and reduced warnings in runtime.</li>
836	<li>XSDDateTime: Use date2 version 3 instead of date3.rb.
837	Date2 version 3 will be included in standard distribution of Ruby/1.8.</li>
838	<li>XSDDateTime: Added XSDDateTimeToTime module to extract a Time object from XSDDateTime, XSDDate and XSDTime.</li>
839	</ul>
840	</dd>
841
842	<dt>Bug fixes</dt>
843	<dd>
844	<ul>
845	<li>Set 'charset=' to content-type when sending back a SOAPFault.
846	It was not set.</li>
847	<li>XSDDateTime: Parsedate was not used. Removed.</li>
848	<li>Added constant Log as a canonical name of Devel::Logger for backward
849	compatibility of devel-logger.</li>
850	<li>Foo = Struct.new(:foo) and Foo = Struct.new("Foo", :foo) could not be
851	unmarshalled collectly. All members were unmarshalled as nil. Fixed.</li>
852	<li>Rescue ArgumentError(Unrecognized signal) in standaloneServer.rb for mswin32 ruby.</li>
853	</ul>
854	</dd>
855	</dl>
856	</dd>
857
858	<dt>1.4.2 - December 28, 2001</dt>
859	<dd>
860	Many changes around Ruby language mapping for SOAP.
861	I replaced DRb's marshalling format with SOAP marshalling and it passed
862	about all unit test packed in DRb package.
863	Only test failed was regards to packet size.
864	You might be able to use SOAP::Marshal.(un\|)marshal for serializing objects
865	instead of Marshal.(load\|dump).
866
867	<ul>
868	<li>Illegal decoding of a position-less element after position-ed element. Fixed.</li>
869	<li>Add Rubytype encoding/decoding support: Regexp, Class, Module and Symbol.</li>
870	<li>Added an option of MappingRegistry to raise an exception when unknown Struct.
871	The option is set 'false' by default so that same behaviour as before.</li>
872	</ul></dd>
873
874	<dt>1.4.1 - December 7, 2001</dt>
875	<dd>SOAP4R/1.4 contained many bugs (as usual...)
876	1.4.1 is a maintenance release. Some bugs are fixed.
877	Thanks to Michael Neumann.
878
879	<ul>
880	<li>instance_eval in SOAPStruct#add for adding accessor illegaly overrode important methods for SOAP4R such as name, name= and so on. Removed this instance_eval and rewrote other codes which did depend the code. Thanks to MNeumann for reporting it and giving a suggestion to fix it.</li>
881	<li>Fixed charset handling. Illegal charset was set when automatic XML processor detecting.</li>
882	<li>Removed unused code(self.decode) in element.rb.</li>
883	<li>Illegal constant access when SOAP format error. Fixed.</li>
884	<li>LiteralEncodingNamespace moved to SOAP module.</li>
885	</ul></dd>
886
887
888	<dt>1.4 - December 5, 2001</dt>
889	<dd><ul>
890	<li>Datatypes:
891	<ul>
892	<li>XSDFloat: Bug in rounding double float to single float. Fixed.</li>
893	<li>SOAPElement: Added for literal encoding.</li>
894	<li>Removed SOAP encoding functions from baseData. EncondingStyleHandler should decide how to encode SOAP data model. (ie. ASP.NET seems to have its own encoding style.)</li>
895	<li>SOAPHeaderItem: Changed interface for easy use.</li>
896	</ul></li>
897
898	<li>SOAP Encoding:
899	<ul>
900	<li>Encoding by itself, not using NQXML's tree object model.</li>
901	<li>At last, supported multi-ref encoding!</li>
902	<li>marshal.rb: Marshalling with Envelope and Body. To marshal multi-ref'd object, Body is needed. CAUTION: Not compatible between former implementation.</li>
903	<li>Add EncodingStyleHandlerLiteral and set it to default.</li>
904	<li>Renamed encoding.rb to encodingStyleHandler.rb.</li>
905	<li>Added ASP.NET encoding handler. ASP.NET seems to use literal encoding (by default) but it is easier with this encodingStyleHandler to access the service which is built with ASP.NET.</li>
906	<li>Changed element name escape.
907	<ul>
908	<li>:: <=> \.\.</li>
909	<li>[^a-zA-Z0-9_-] <=> \.[0-F][0-F]
910	</ul>
911	Limitation: Using SOAP4R's RPC function, you cannot use the name which contains '.' for method name, class/struct name, and accessor name. In Ruby world, it should not be a problem I believe.</li>
912	</ul></li>
913
914	<li>RPC related functions:
915	<ul>
916	<li>Driver: Added 'invoke' method for messaging.</li>
917	<li>Driver: Content of SOAPFault detail element is set in the exception which is thrown from SOAP Node to client application.</li>
918	<li>Processor: Changed Processor.(un\|)marshal interface. An instance of NS for parsing/generating XML instance is prepared in parser/generator.</li>
919	<li>mappingRegistry.rb is devided from rpcUtils.rb.</li>
920	</ul></li>
921	</ul></dd>
922
923
924	<dt>1.3.8 - October 4, 2001</dt>
925	<dd>Feedback from
926	<a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab "Round 2"</a>
927	and Michael Neumann. Thanks!
928
929	<ul>
930	<li>Datatypes:
931	<ul>
932	<li>XSDFloat: Creating float data from junk string such as "123.0junk" was
933	converted to 0.0. It should be avoided. Fixed.</li>
934	<li>XSDFloat: Fixed double -> single rounding code.</li>
935	</ul></li>
936
937	<li>RPC related functions:
938	<ul>
939	<li>Changed typename <=> NCName strategy. '::' <=> '.'</li>
940	<li>Added mappingRegistry argument to interfaces for SOAP object creation.</li>
941	</ul></li>
942
943	<li>Others:
944	<ul>
945	<li>Set faultstring '(No faultstring)' to SOAP Fault when empty faultstring element.</li>
946	<li>server.rb: Added mappingRegistry interface.</li>
947	<li>marshal.rb: Create NCName from typename.</li>
948	</ul></li>
949	</ul></dd>
950
951
952	<dt>1.3.7 - August 24, 2001</dt>
953	<dd>Feedback from
954	<a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab "Round 2"</a>
955	and Michael Neumann. Thanks!
956
957	<ul>
958	<li>Datatypes:
959	<ul>
960	<li>All datatypes try to keep nil correctly.</li>
961	<li>XSDInt/Integer/Long: to_i -> Integer() to detect format error.</li>
962	<li>XSDDateTime, XSDDate, XSDTime: Add trailing 'Z' to indicate UTC.</li>
963	<li>SOAPStruct: Accept untyped struct.</li>
964	<li>Map(Hash): Let <item> untyped.</li>
965	<li>Apache allows only 'item' in Map type.</li>
966	</ul></li>
967
968	<li>Stream handler:
969	<ul>
970	<li>Removed MPOST support.</li>
971	<li>ECONNRESET was not caught. Fixed.</li>
972	<li>Added timeout support.</li>
973	</ul></li>
974
975	<li>Others:
976	<ul>
977	<li>Changed using URI library: URb -> URI; following its name change.</li>
978	<li>Added NQXML/1.1.0 support. A XMLDecl now recognized as a XMLDecl, not a PI.</li>
979	</ul></li>
980	</ul></dd>
981
982	<dt>1.3.6 - July 27, 2001</dt>
983	<dd>Many feedbacks from Michael Neumann. Thanks!
984
985	<ul>
986	<li>hexBinary type: Added.</li>
987	<li>nil type: Should not be xsd:nil but xsi:nil.</li>
988	<li>Added StandaloneServer implementation. Thanks to Michael Neumann!</li>
989	<li>Illegal parsing of XMLDecl. Fixed.</li>
990	<li>RPC's 'inout' param was not supported. Fixed. Thanks to Michael Neumann!</li>
991	<li>URb::Generic#path returns '' when abs_path is empty (such as http://foo).
992	Added checking code.</li>
993	<li>Use http-access2 instead of original HTTP implementation. http-access2 supports HTTP/1.1's persistent connection.</li>
994	</ul></dd>
995
996	<dt>1.3.5 - July 14, 2001</dt>
997	<dd>Many feedbacks from Michael Neumann.
998	I much appreciate valuable comments to him.
999	Thanks!
1000
1001	<ul>
1002	<li>Changed using URI library: uri -> URb.</li>
1003	<li>Types changed:
1004	<ul>
1005	<li>All: Triming data except XSDString before parsing it.</li>
1006	<li>String: Regexp for XML Char check did not work under $KCODE = 'UTF8' condition. Fixed.</li>
1007	<li>Nil: 2001xsd:nil must not accept a value '1'. 1999xsd:null must not accept a value 'true' because these are not a boolean but only a flag for nil. Fixed.</li>
1008	</ul>
1009	</li>
1010
1011	<li>Supported XML parser:
1012	<ul>
1013	<li>Added automatic CES conversion support for NQXMLParser.
1014	(Depends on uconv module).
1015	Set $KCODE for regexps used in NQXML parser.</li>
1016	<li>Moved SOAPNQXML*Parser to nqxmlparser.rb.</li>
1017	</ul>
1018	</li>
1019
1020	<li>RPC related functions changed:</li>
1021	<ul>
1022	<li>Added marshalling/unmarshalling Ruby's object using SOAP Encoding.</li>
1023	<li>Parallelize of signatures of 'addMethod': proxy.rb <-> rpcRouter.rb, driver.rb <-> cgistub.rb.</li>
1024	<li>Void return if 'retval' is not defined.</li>
1025	<li>Added SOAP's Long type to default mapping table.</li>
1026	</ul>
1027	</li>
1028	</ul></dd>
1029
1030	<dt>1.3.4.2 - July 11, 2001</dt>
1031	<dd>SOAP4R/1.3.4 was once packed in July 10, 2001.
1032	But, thanks to MNeumann and knu,
1033	I found I had forgotten to pack 'redist' directory with it.
1034	I added some fix from developing version and repack it as 1.3.4.2.
1035	Sorry for frequently release...
1036	<br/><br/>
1037
1038	Feedback from
1039	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
1040	and Michael Neumann. Thanks!
1041
1042	<ul>
1043	<li>Added in 1.3.4.2:
1044	<ul>
1045	<li>Type Decimal: Silly bug fixed. 0.0001 was converted to 0.1</li>
1046	<li>CGIStub returns HTTP status 500 when returning SOAP Fault.
1047	Returned 200 because I don't like this spec., but SOAP/1.2 W3C WD
1048	9 July 2001 have adopted it. Hmm...</li>
1049	<li>RPC client(driver.rb): Exception#set_backtrace was omitted when transmitting exception by SOAP Fault.</li>
1050	</ul>
1051	</li>
1052	<li>Types changed:
1053	<ul>
1054	<li>Array: Incomplete sparse array support. Fixed.</li>
1055	<li>Date: Added.</li>
1056	<li>Time: Added.</li>
1057	<li>DateTime: Added precision of time support.</li>
1058	<li>String: Default data should not be nil but ''.</li>
1059	<li>Nil: Attribute value of xsi:nil might be '1' instead of 'true'. Fixed.</li>
1060	</ul>
1061	</li>
1062
1063	<li>Supported XML parser:
1064	<ul>
1065	<li>Added SOAPXMLParser and SOAPSAXDriver for XMLParser which uses expat.
1066	You can get the module from RAA: <a href="http://raa.ruby-lang.org/list.rhtml?name=xmlparser">XMLParser module</a>.<br/>
1067	To use XMLParser -> add "require 'soap/xmlparser'".<br/>
1068	To use SAX driver of XMLParser -> add "require 'soap/saxdriver'".<br/>
1069	To use NQXMLParser -> nothing to do.<br/>
1070	FYI:
1071	<ul>
1072	<li>XMLParser version is faster than others</li>
1073	<li>SAXDriver version is extremely slow</li>
1074	<li>NQXMLParser version is somewhat slower than XMLParser version</li>
1075	<li>XMLParser is a Ruby extension module; To use it, you must compile and install it.</li>
1076	<li>So far, automatic code conversion support is for XMLParser and SAXDriver. See below.</li>
1077	</ul>
1078	</li>
1079	<li>Added automatic CES conversion support: UTF-8 <-> EUC, SJIS.
1080	Requires Uconv module. Works with XMLParser module only now.</li>
1081	<li>Added XMLDecl for CES.</li>
1082	</ul>
1083	</ul></dd>
1084
1085	<dt>1.3.3 - July 4, 2001</dt>
1086	<dd>Feedback from
1087	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
1088	and Michael Neumann. Thanks!
1089	<ul>
1090	<li>Added SOAP4R Installer by Michael Neumann. Thanks!</li>
1091	<li>Types changed:
1092	<ul>
1093	<li>Boolean: Accepts 1 and 0 in addition to true and falue.</li>
1094	<li>Float: handles single-precision 32-bit floating point.
1095	Ruby's float is doule-precision.</li>
1096	<li>Double: Added. Mapped to Ruby's Float.</li>
1097	<li>DateTime: Added TZ support.</li>
1098	<li>Long: Added.</li>
1099	<li>Int: Changed class hierarchy; derived from Long now.</li>
1100	<li>Array: Added 'position' and 'offset' support.</li>
1101	<li>Array: Added M-D Array support.</li>
1102	<li>Decimal: Added but it's incomplete now.</li>
1103	</ul>
1104	</li>
1105	<li>Illegal error message when a type not found in SOAP-ENC.</li>
1106	<li>Tries to transmit \r safely. To be checked...</li>
1107	<li>Parse Fault items like 'faultcode' as same as Body ie. href/id.</li>
1108	<li>rpcUtils.rb was completely re-written.
1109	<ul>
1110	<li>Added mappingRegistry interface.</li>
1111	<li>Changed soap2obj and obj2soap's interface.</li>
1112	<li>Bignum might be int or integer. It's dependent on platform.
1113	Changed to check range -2147483648~+2147483647 itself.</li>
1114	<li>ary2md: Added. Converting Array ((of Array)...) to M-D Array.</li>
1115	<li>struct2obj: Illegal dependency on ordering of Struct#members. Fixed.</li>
1116	<li>Ruby's Array should be converted to SOAP's Array of anyType. Fixed.</li>
1117	</ul>
1118	</li>
1119	<li>Dump HTTP header even when an error was raised.</li>
1120	</ul></dd>
1121
1122	<dt>1.3.2 - June 21, 2001</dt>
1123	<dd>Feedback from
1124	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
1125
1126	<ul>
1127	<li>"nil='1'" should be "nil='true'" in 2001 schema
1128	whereas "null='1'" in 1999 schema. Fixed.</li>
1129	<li>SOAP Array was not typed with xsi:type.</li>
1130	<li>Fixed serialization root handling algorithm.</li>
1131	<li>Supported kind of SOAP-ENC:String style typed element.</li>
1132	<li>Default namespace was not derived to child element. Fixed.</li>
1133	<li>Support default encodingStyle.</li><