You are viewing a plain text version of this content. The canonical link for it is here.
Posted to soap-dev@xml.apache.org by Scott Nichol <sn...@computer.org> on 2001/02/13 04:34:31 UTC

[PATCH] Cosmetic improvement of release notes and installation for 2.1

I believe others are working on a re-work of some of the docs, but I thought
I'd send these cosmetic changes to improve the polish of the package in the
interim.

Scott Nichol

--- soap-2_1\ReleaseNotes.html Mon Feb 12 08:15:42 2001
+++ soap-2_1-new\ReleaseNotes.html Mon Feb 12 22:08:11 2001
@@ -4,14 +4,14 @@
 <meta http-equiv="Content-Type"
 content="text/html; charset=iso-8859-1">
 <meta name="GENERATOR" content="Microsoft FrontPage Express 2.0">
-<title>XML-SOAP v1.2 Release Notes</title>
+<title>XML-SOAP v2.1 Release Notes</title>
 </head>

 <body bgcolor="#FFFFFF">

-<h1 align="center">Apache-SOAP Version 2.0: Release Notes</h1>
+<h1 align="center">Apache-SOAP Version 2.1: Release Notes</h1>

-<p align="center">August 18, 2000.</p>
+<p align="center">February 5, 2001.</p>

 <p align="left">See <a href="docs/install/index.html">here</a>
 for Installation Instructions.</p>
--- soap-2_1\docs\install\index.html Mon Feb 12 08:15:42 2001
+++ soap-2_1-new\docs\install\index.html Mon Feb 12 22:24:06 2001
@@ -4,9 +4,7 @@

 <h2 align="center">Installation Instructions</h2>

-<h2 align="center"><em>NEEDS TO BE UPDATED FOR 2.1</em></h2>
-
-<p align="center">August, 2000.</p>
+<p align="center">February 5, 2000.</p>

 <p>The Apache-SOAP distribution can be installed for use as a
 client or as a server. This document provides installation
@@ -17,7 +15,7 @@

 <p>We assume that you have downloaded the binary distribution of
 Apache-SOAP and have extracted the archive into the directory
<tt>/foo</tt>.
-Thus the files from the distribution are in the directory
<tt>/foo/soap-2_0/</tt>.</p>
+Thus the files from the distribution are in the directory
<tt>/foo/soap-2_1/</tt>.</p>

 <p>Note that if you are on a Win32 machine then you should
 replace &quot;/&quot; with &quot;\&quot; as you follow these
@@ -45,9 +43,9 @@
 JavaBeans Activation Framework</a>, downloadable from
 Sun. Place mail.jar and activation.jar in your classpath.</p>

-<p><strong>Classpath</strong>: Add <tt>/foo/soap-2_0/lib/soap.jar</tt>
+<p><strong>Classpath</strong>: Add <tt>/foo/soap-2_1/lib/soap.jar</tt>
 to your classpath. If you want to run the samples, you also need
-to add <tt>/foo/soap-2_0</tt> to your classpath.</p>
+to add <tt>/foo/soap-2_1</tt> to your classpath.</p>

 <h2>Client-Side Instructions</h2>

@@ -69,16 +67,15 @@
     <li><a href="weblogic.html">WebLogic Application Server v5.1</a></li>
     <li><a href="websphere.html">IBM WebSphere v3.5</a></li>
     <li><a href="JRun.html">JRun 3.0</a></li>
-    <li>Microsoft Internet Information Server</li>
 </ul>

 <p>Didn't find yours listed? See whether the instructions for
-Tomcat (for example) gives you enough hints on how to do it. If
+the servers listed above give you enough hints on how to do it. If
 not, you should try asking on the Apache-SOAP user's list; more
 than likely someone else has done it already. You can subscribe
 to the list here: <a
href="http://xml.apache.org/soap/mail.html">http://xml.apache.org/soap/mail.
html</a>.</p>

-<h1>Troubleshooting Installation Problems</h1>
+<h2>Troubleshooting Installation Problems</h2>

 <table border="1" width="100%">
     <tr>
@@ -87,23 +84,23 @@
     </tr>
     <tr>
         <td width="25%">I get an exception saying getAttributeNS
-        is not found</td>
+        is not found.</td>
         <td width="50%">Classpath is not correctly set - you
         still have some old parser or some other JAR file that
         has the org.w3c.dom.* classes <em>ahead</em> of xerces.jar
-        from Xerces 1.1.2 or later.</td>
-    </tr>
-    <tr>
-        <td width="25%">x</td>
-        <td width="50%">y</td>
-    </tr>
-    <tr>
-        <td width="25%">x2</td>
-        <td width="50%">y2</td>
+        from Xerces 1.1.2 or later.  The issue is almost certainly with
+        the classpath configuration of your server (e.g. Tomcat),
+        not the classpath in your shell environment, as most servers
+        set their own classpath.</td>
     </tr>
     <tr>
-        <td width="25%">x3</td>
-        <td width="50%">y3</td>
+        <td width="25%">Others</td>
+        <td width="50%">Use the mail lists (info at:
+         <a href="http://xml.apache.org/soap/mail.html">
+         http://xml.apache.org/soap/mail.html</a>).  Once
+         you subscribe to a list, you can query the archives
+         as well as post and read messages.
+        </td>
     </tr>
 </table>
 </body>
--- soap-2_1\docs\install\jrun.html Mon Feb 12 08:15:42 2001
+++ soap-2_1-new\docs\install\jrun.html Mon Feb 12 22:26:54 2001
@@ -9,7 +9,7 @@

 <body bgcolor="#FFFFFF">

-<h1 align="center">Apache-SOAP Version 2.0: Installing the Server-Side
Under JRun 3.0</h1>
+<h1 align="center">Apache-SOAP Version 2.1: Installing the Server-Side
Under JRun 3.0</h1>

 <p><strong>IMPORTANT</strong>: JRun comes with an XML parser, which will by
default hide Xerces and therefore cause problems with your SOAP
installation.  Please follow step 1 below!</p>

--- soap-2_1\docs\install\weblogic.html Mon Feb 12 08:15:42 2001
+++ soap-2_1-new\docs\install\weblogic.html Mon Feb 12 22:28:41 2001
@@ -9,7 +9,7 @@

 <body bgcolor="#FFFFFF">

-<h1 align="center">Apache-SOAP Version 2.0: Installing the Server-Side
Under WebLogic
+<h1 align="center">Apache-SOAP Version 2.1: Installing the Server-Side
Under WebLogic
   Application Server 5.1</h1>

 <p><strong>IMPORTANT</strong>: WebLogic comes with an XML parser. So, you
must
--- soap-2_1\docs\install\tomcat.html Mon Feb 12 08:15:42 2001
+++ soap-2_1-new\docs\install\tomcat.html Mon Feb 12 22:29:44 2001
@@ -9,7 +9,7 @@

 <body bgcolor="#FFFFFF">

-<h1 align="center">Apache-SOAP Version 2.0: Installing the Server-Side
+<h1 align="center">Apache-SOAP Version 2.1: Installing the Server-Side
 Under Apache Tomcat v3.1</h1>

 <p><strong>IMPORTANT</strong>: Tomcat comes with an XML parser
(lib/xml.jar)