updated INSTALL to be more relevant.. more fixes coming (at some point)

1 files changed, 33 insertions, 28 deletions

diff --git a/INSTALL b/INSTALL
index af0b981918..2d1f8eb68a 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,9 +1,17 @@
 Installation Instructions for PHP 4.1
 -------------------------------------
 
-For the impatient here is a quick set of steps that will build PHP as
-first a dynamic Apache module (DSO) for Apache 1.3.x with MySQL support 
-and then a static module.  A more verbose explanation follows.  
+STOP!
+
+Before going any further, please remember you are going to find more 
+up to date instructions in the online manual, located here:
+
+http://www.php.net/manual/en/install.apache.php
+
+It is strongly recommended that you read the manual page before going
+further. However, for the impatient, here is a quick set of steps that 
+will build PHP as (first) a dynamic Apache module (DSO) for Apache 1.3.x 
+with MySQL support and then a static module.  A more verbose explanation follows.  
 
 For installing PHP on other web servers, refer to one of the following
 files:
@@ -14,24 +22,26 @@ files:
     sapi/thttpd/README
     README.Zeus
 
-Note!  Only install either the static module or the dynamic one.  Do not
-install both.  
+Some notes:
+
+1: Only install either the static module or the dynamic one.  Do not
+   install both.  
 
-Note 2!  If you are recompiling PHP to add new extensions or upgrading
-something like GD, remove the config.cache file before you re-run 
-configure.
+2:  If you are recompiling PHP to add new extensions or upgrading
+    something like GD, remove the config.cache file before you re-run 
+    configure.
 
-Note 3!  If you are on Linux and have installed shared libraries, make
-sure the location of these shared libraries are listed in your 
-/etc/ld.so.conf file.  For example, if you have:
+3:  If you are on Linux and have installed shared libraries, make
+    sure the location of these shared libraries are listed in your 
+    /etc/ld.so.conf file.  For example, if you have:
 
-  /usr/local/lib/mysql/libmysqlclient.so
+       /usr/local/lib/mysql/libmysqlclient.so
 
-Make sure /etc/ld.so.conf contains:
+    Make sure /etc/ld.so.conf contains:
 
-  /usr/local/lib/mysql
+      /usr/local/lib/mysql
 
-Then run ldconfig.
+    Then run ldconfig.
 
 If you want both PHP 3 and 4 modules in the same Apache server, check the
 bottom of this file for instructions.
@@ -85,7 +95,7 @@ $ cd ..
 
 $ gunzip -c php-4.1.x.tar.gz | tar xf -
 $ cd php-4.1.x
-$ ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars
+$ ./configure --with-mysql --with-apache=../apache_1.3.x
 $ make
 $ make install
 
@@ -380,16 +390,11 @@ WHY DISABLING -fPIC WORKS ON LINUX
 
 USING PHP 3 AND PHP 4 AS CONCURRENT APACHE MODULES
 
-   Recent operating systems provide the ability to perform versioning and
-   scoping. This features make it possible to let PHP 3 and PHP 4 run as
-   concurrent modules in one Apache server. 
-   
-   This feature is known to work on the following platforms:
+   With some (newer) installations of Apache, it's possible to compile both
+   PHP 3 and PHP 4, and run them concurrently. 
 
-   - Linux with recent binutils (binutils 2.9.1.0.25 tested)
-   - Solaris 2.5 or better
-   - FreeBSD (3.2, 4.0 tested)
-   - IRIX64 6.5
+   Note, it's only really wise to do this if you need to use the PHP 3 engine
+   to maintain backwards compatibility. 
    
    To enable it, configure PHP 3 and PHP 4 to use APXS (--with-apxs) and the
    necessary link extensions (--enable-versioning). Otherwise, all standard
@@ -399,8 +404,8 @@ USING PHP 3 AND PHP 4 AS CONCURRENT APACHE MODULES
 				--with-apxs=/apache/bin/apxs \
 				--enable-versioning \
 				--with-mysql \
-				--enable-track-vars
 
-   If this also works on your platform or if you know a way to do it, please
-   report it to our bug database at http://bugs.php.net
+
+
+