Allow more advanced element focusing
[squirrelmail.git] / doc / INSTALL
index d618837651a0bf749f78b6e1f2da307d2bbe8494..d12c5fb1bc631f24c11852fa285036067b1f0d06 100644 (file)
@@ -1,6 +1,13 @@
 Installing SquirrelMail
 =======================
 
+NOTE!  More thorough and possibly up-to-date information about how
+to install, use and maintain SquirrelMail is available in our online
+documentation here:
+
+http://squirrelmail.org/docs/admin/admin.html
+
+
 Table of Contents:
   0.  (QUICK!)   Quick install guide
   1.  (PHP)      Configure your webserver to work with PHP
@@ -49,11 +56,16 @@ Each of these steps is covered in detail below.
   --with-ldap
     Required for LDAP addressbooks
 
-  --with-pear and --with-mysql
-    For MySQL storage of preferences or addressbooks. You will need PHP
-    compiled with --with-pgsql option, if you want to use PostgreSQL instead
-    of MySQL. You will need PHP with appropriate database extension, if you
-    want to use any other database.
+  --with-pear 
+    If you do not have PHP PDO (which should come preinstalled with
+    PHP version 5.1 and above) and you plan to store user preferences
+    or address books in a database, you will need PHP compiled with
+    the above option.  ALSO, you need to build the database driver
+    relevant to your database:
+  --with-mysql for MySQL
+  --with-pgsql for PostgreSQL 
+    Again, this is only required for versions of PHP that do not 
+    have PDO.
 
   --with-openssl
     Required for encrypted IMAP or SMTP connections (TLS)
@@ -148,8 +160,7 @@ b. Setting up directories
   deletes everything in the attachment directory.  Something similar
   to the following will be good enough:
 
-    $ cd /var/local/squirrelmail/attach
-    $ rm -f *
+    $ cd /var/local/squirrelmail/attach && rm -f *
 
   However, this will delete attachments that are currently in use by people
   sending email when the cron job runs.  You can either (1) make sure that
@@ -162,7 +173,7 @@ b. Setting up directories
   attachment directory is the same as your data directory) might look like
   this:
 
-    $ rm `find /var/local/squirrelmail/attach -atime +2 | grep -v "\." | grep -v _`
+    $ find /var/local/squirrelmail/attach -type f -atime +2 -exec rm {} \;
 
   Remember to be careful with whatever method you do use, and to test out
   the command before it potentially wipes out everyone's preferences.