Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml,v
diff -u -r1.12.2.1 -r1.12.2.2
--- openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml	5 Jul 2004 19:47:37 -0000	1.12.2.1
+++ openacs-4/packages/acs-core-docs/www/xml/install-guide/software.xml	14 Nov 2004 21:48:06 -0000	1.12.2.2
@@ -13,9 +13,9 @@
     
     <para>
 	OpenACS requires, at a minimum, an operating system, database,
-	and webserver.  Many additional programs, such as a Mail
-	Transport Agent and source control system, are also needed for
-	a fully effective instance.
+	and webserver to work.  Many additional programs, such as a build environment, Mail
+	Transport Agent, and source control system, are also needed for
+	a fully effective installation.
   </para>
 
     <table id="compatibility-matrix">
@@ -122,14 +122,17 @@
         </tbody>
       </tgroup>
     </table>
-
+    <para>The OpenACS installation instructions assume the operating system and build environment are installed.
+    The instructions explain installation of TCL, tDOM, tclwebtest, a Web Server, a Database, a Process Controller, and 
+    Source Control software. The following external links are for reference only.  
+    </para>
       <itemizedlist>
         <listitem id="openacs-download"><formalpara><title><ulink
             url="http://openacs.org/projects/openacs/download/">OpenACS &version;</ulink></title>
             <para>The OpenACS tarball comprises the core packages and
             many useful additional packages.  This includes a full set
             of documentation.  The tarball works with both PostgreSQL
-            and Oracle.</para>
+            and Oracle. Some scripts require bash shell.</para>
           </formalpara>
         </listitem>
         
@@ -152,11 +155,11 @@
               <formalpara>
                 <title>FreeBSD</title>
                 <para><ulink url="http://www.orchardlabs.com/freebsd/">FreeBSD
-                guide</ulink>.  The Reference Platform uses bash, which is the
+                guide</ulink>.  The OpenACS Reference Platform uses shell scripts written for bash, which is the
               standard Linux shell.  If you are using a different
               shell, you will need to substitute your shell's
               conventions for setting environment variables when
-              appropriate.</para>
+              appropriate, and install bash to work with the scripts.</para>
               </formalpara>
             </listitem>
             <listitem>
@@ -204,7 +207,7 @@
 			  whereas on BSD distributions,
 			  <computeroutput>make</computeroutput> and
 			  <computeroutput>gmake</computeroutput> are
-			  different.</para>
+			  different --use gmake.</para>
               </formalpara>
             </listitem>
           </itemizedlist>
@@ -219,9 +222,9 @@
               <formalpara>
                 <title>TCL 8.3, REQUIRED</title>
                 <para>OpenACS is written in TCL, an interpreted
-              language.  The TCL interpreter must be installed for
-              OpenACS to function.  TCL is included in most standard
-              distributions. </para>
+              language.  A threaded version of the TCL interpreter must be installed for
+              OpenACS to work.  The TCL interpreter that is included in most standard
+              distributions may not be thread safe.  </para>
               </formalpara>
             </listitem>
             <listitem>
@@ -313,13 +316,13 @@
         </para></listitem>
                 
                 <listitem><para>
-          The patch that makes <computeroutput>ns_uuencode</computeroutput>
+          The patch for aolserver 3.x that makes <computeroutput>ns_uuencode</computeroutput>
           work for binary files is available at <ulink
           url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=474259&amp;group_id=3152&amp;atid=303152">sourceforge.net</ulink>
         </para></listitem> 
                 
                 <listitem><para>
-          The patch that makes AOLserver respect the
+          The patch that makes AOLserver 3.x respect the
           <computeroutput>-g</computeroutput> flag is available at
           <ulink
           url="http://sourceforge.net/tracker/index.php?func=detail&amp;aid=509413&amp;group_id=3152&amp;atid=303152">sourceforge.net</ulink>
@@ -329,13 +332,15 @@
             </listitem>
             <listitem id="nsopenssl-download">
               <formalpara>
-                <title><ulink
-              url="http://www.scottg.net/download/nsopenssl-2.1a.tar.gz">nsopenssl 2.1a</ulink>, OPTIONAL</title>
+                <title>nsopenssl, OPTIONAL</title>
                 <para>Provides SSL capabilities for AOLserver.  It requires
 	    OpenSSL.  You need this if you want users to make
-	    secure (https) connections to your webserver. (<ulink
-              url="http://www.scottg.net/webtools/aolserver/modules/nsopenssl/">home
-              page</ulink>)</para>
+	    secure (https) connections to your webserver. 
+            aolserver3.x requires <ulink
+              url="http://www.scottg.net/download/nsopenssl-2.1a.tar.gz">nsopenssl 2.1a</ulink>. aolserver4.x requires nsopenssl3; see
+              url="http://www.aolserver.com/">aolserver.com</ulink> for latest release. (<ulink
+              url="http://www.scottg.net/webtools/aolserver/modules/nsopenssl/">home page</ulink>)
+                </para>
               </formalpara>
             </listitem>
             
@@ -410,7 +415,7 @@
             <title>Database</title>
             <para>The data on your site (for example, user names and passwords,
         calender entries, and notes) is stored in the database.
-        OpenACS seperates the database with an abstraction layer,
+        OpenACS separates the database with an abstraction layer,
         which means that several different databases all function
         identically.  While you can run the core OpenACS on any
         supported database, not all contributed packages support all