using squirrelmail api for error message

[squirrelmail.git] / UPGRADE

diff --git a/UPGRADE b/UPGRADE
index 396c791413907447b578e353a85cbe3c1ec0bcef..ee77526ae7444ea5f7a4d069b88619880a837993 100644 (file)
--- a/UPGRADE
+++ b/UPGRADE
@@ -7,7 +7,7 @@ using a previous version (0.1 or 0.2), it is suggested that you just start
 from scratch and configure your settings as if it was your first install.
 
 NOTE: The new plugin architecture required the use of some functions which
-are not in all versions of PHP4. You will need at least PHP4 beta2. If you
+are not in all versions of PHP4. You will need at least PHP 4.1.0. If you
 need to upgrade please go ahead and install the latest release version of
 PHP4.
 
@@ -68,16 +68,13 @@ C.  Copy plugins
 
 Like SquirrelMail, plugins are frequently updated for improvements, as well
 as to make them compatible with new SquirrelMail releases.  It is suggested
-that you download a new plugins archive at the same time you download your
-SquirrelMail install, and that you install your plugins fresh (it's easy,
-don't panic!).
+that you download new versions of your plugins at the same time you download
+your SquirrelMail install, and that you install your plugins fresh (it's
+easy, don't panic!).
 
-If you prefer to just copy your old plugins over (if it's the same version
-or if you are lazy), you may do so.  If you notice irregularities with the
-plugins under the new SquirrelMail, try installing new versions of the
-plugins.
-
-  $ cp -Rp squirrelmail-1.0.6.bak/plugins/* squirrelmail-1.2.0/plugins
+You should not try replacing plugins that are already included in SquirrelMail
+package. Download latest versions of plugins that are not included in new
+SquirrelMail package or copy them from older SquirrelMail install.
   
 D.  Copy themes
 
@@ -85,7 +82,11 @@ If you've created or modified themes, you should copy just those to the new
 SquirrelMail themes directory.  To just copy them all over to the new
 SquirrelMail installation, you can run one command.
 
-  $ cp squirrelmail-1.0.6.bak/themes/* squirrelmail-1.2.0/themes/
+  $ cp -ui squirrelmail-1.0.6.bak/themes/* squirrelmail-1.2.0/themes/
+
+When -u flag is used, command copies only missing and newer files. 
+When -i flag is used, command asks for confirmation before replacing
+existing files.
 
 (While you are at it, you should send them to us!  We might add them to the
 themes in the standard install!)
@@ -98,10 +99,10 @@ example, we assume that user "nobody" and group "nobody" are the web server
 as is often the case with Apache.
 
   $ cd squirrelmail-1.2.0
-  $ chown -R nobody.nobody data
+  $ chown -R nobody:nobody data
   
 See INSTALL for alternate userid/groupid pairs.  Additionally, if "chown
-user.group" doesn't work, you can use "chown user" and "chgrp group"
+user:group" doesn't work, you can use "chown user" and "chgrp group"
 instead.  See the man pages for these commands for more information.
 
 
@@ -111,15 +112,10 @@ Run config/conf.pl to see the new configuration options available with the
 new version, as well as to verify that all of your old options are set
 properly.
 
-When you have migrated plugins from your old install to your new
-install, or even use any plugins at all, you *must* run conf.pl and do
-the following:
-
-A.  Select "8" (Plugins)
-B.  Select "A" (Sanitize all plugins for use with Squirrelmail 1.2)
+Always save your options, also if you haven't changed anything.
+This will ensure that any problems with conf.pl that might have been solved
+are effective to your installation.
 
-This will make sure the plugins work more efficiently (and will
-release you from any "cannot redeclare" error messages).
 
 6.  DONE!
 =========