updated installation instructions

diff --git a/INSTALL b/INSTALL
index 3362abd7215846f4a5b8f07962d302e3c31388c5..634859764798ec2039abd6c4852ae2013a62a4a1 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,6 +1,18 @@
 
 Friendika Installation
 
+We've tried very hard to ensure that Friendika will run on commodity hosting 
+platforms - such as those used to host Wordpress blogs and Drupal websites. 
+But be aware that Friendika is more than a simple web application. It is a 
+complex communications system which more closely resembles an email server 
+than a web server. For reliability and performance, messages are delivered in
+the background and are queued for later delivery when sites are down. This
+kind of functionality requires a bit more of the host system than the typical
+blog. Not every PHP/MySQL hosting provider will be able to support Friendika. 
+Many will. But please review the requirements and confirm these with your 
+hosting provider prior to installation.
+
+
 1. Requirements
        - Apache with mod-rewrite enabled and "Options All" so you can use a 
 local .htaccess file
@@ -9,46 +21,39 @@ local .htaccess file
 encryption support
                - PHP *command line* access with register_argc_argv set to true in the 
 php.ini file
-               - curl, gd, and openssl extensions
+               - curl, gd, mysql, and openssl extensions
 
        - Mysql 5.x
 
        - ability to schedule jobs with cron (Linux/Mac) or Scheduled Tasks
 (Windows)
-       
+
+       - At this time we require the installation to be at the top level of a 
+domain or sub-domain (without an extra path). This requirement may change in
+the future.
+
        [Dreamhost.com offers all of the necessary hosting features at a 
 reasonable price. If your hosting provider doesn't allow Unix shell access, 
 you might have trouble getting everything to work.] 
 
-2. Put this directory into the root of your web server document area.
+2. Unpack the Friendika files into the root of your web server document area.
 
        - If you copy the directory tree to your webserver, make sure
        that you also copy .htaccess - as "dot" files are often hidden 
        and aren't normally copied.
 
-       - To use a subdirectory of your main domain, set the 
-       config variable $a->path to the relative subdir
-       in .htconfig.php - for example to use http://example.com/test - 
-       use
-               $a->path = 'test';
-
-       NOTE: This has NOT been fully tested!
-       In this case, you cannot use the web installer. 
-       Skip step 4 and proceed to step 5 - especially steps 5a and 5b.
-
-       - Everything will work much better if you can dedicate a domain 
-       or subdomain so that you don't require an extra server path. 
-
-3. Create an empty database and note the access details (hostname, username, password, database name).
+3. Create an empty database and note the access details (hostname, username, 
+password, database name).
 
-4. Visit your website with a web browser and follow the instructions. 
+4. Visit your website with a web browser and follow the instructions. Please 
+note any error messages and correct these before continuing.
 
 5. *If* the automated installation fails for any reason, check the following:
 
-       5a. ".htconfig.php" exists 
+       - ".htconfig.php" exists 
                If not, edit htconfig.php and change system settings. Rename 
 to .htconfig.php
-       5b. Database is populated.
+       -  Database is populated.
                If not, import the contents of "database.sql" with phpmyadmin 
 or mysql command line
 
@@ -69,7 +74,7 @@ Change "/base/directory", and "/path/to/php" as appropriate for your situation.
 If you are using a Linux server, run "crontab -e" and add a line like the 
 one shown, substituting for your unique paths and settings:
 
-*/5 * * * *    cd /home/myname/mywebsite; /usr/bin/php include/poller.php
+*/10 * * * *   cd /home/myname/mywebsite; /usr/bin/php include/poller.php
 
 You can generally find the location of PHP by executing "which php". If you 
 have troubles with this section please contact your hosting provider for