New upstream release

[roundcube.git] / UPGRADING

diff --git a/UPGRADING b/UPGRADING
index 9d87a1e38e91321a415349c11ab6c91ac9875c9b..6362e0ca54678ad90b434f5cfc7cf6d7fe334eaf 100644 (file)
--- a/UPGRADING
+++ b/UPGRADING
@@ -1,15 +1,82 @@
-UPDATE instructions
-===================
+UPGRADING instructions
+======================
 
-Follow these instructions if upgrading from a previous version
+First you should remove all subfolders from /program/localization/
+because most language codes have changed in 0.2-alpha. This way you
+can make sure that no old localization files remain on your disk.
+
+Then follow these instructions if upgrading from a previous version
 of RoundCube Webmail.
 
+1. Replace index.php and all files in
+   - ./bin/
+   - ./SQL/
+   - ./program/
+   - ./installer/
+   - ./skins/default/
+   - ./plugins/
+2. Run ./bin/update.sh from the commandline OR
+   open http://url-to-roundcube/installer/ in a browser. To enable
+   the latter one, you have to temporary set 'enable_installer' to true
+   in your local config/main.inc.php file.
+3. Let the update script/installer check your configuration and
+   update your config files as suggested by the updater.
+4. If suggested by the update script, run all commands in
+   ./SQL/[yourdbtype].update.sql that are superscribed with the
+   currently installed version number.
+5. Make sure 'enable_installer' is set to false again.
+6. Check .htaccess settings (some php settings could become required)
+
+
+For manually upgrading your RoundCube installation follow the instructions
+that match the currently installed version:
+
+from version 0.2-alpha
+----------------------------------------
+* replace index.php
+* replace all files in folder /bin/
+* replace all files in folder /program/
+* replace all files in folder /installer/
+* replace all files in folder /skins/default/
+* run all commands in SQL/[yourdbtype].update.sql
+  below the line "-- Updates from version 0.2-alpha"
+* check the config/main.inc.php.dist for new configuration 
+  options and add them to your config 
+  WARNING: 'skin_path' option was replaced by 'skin' option
+* WARNING: 'db_backend' option has been removed, now only
+  PEAR::MDB2 driver is supported
+
+
+from version 0.1.1
+----------------------------------------
+* replace index.php
+* replace all files in folder /bin/
+* replace all files in folder /program/
+* replace all files in folder /skins/default/
+* run all commands in SQL/[yourdbtype].update.sql
+  below the line "-- Updates from version 0.1.1"
+* check the config/main.inc.php.dist for new configuration 
+  options and add them to your config 
+
+
+from version 0.1-stable
+----------------------------------------
+* replace index.php
+* replace all files in folder /bin/
+* replace all files in folder /program/
+* replace all files in folder /skins/default/
+* run all commands in SQL/[yourdbtype].update.sql
+* check the config/main.inc.php.dist for new configuration options
+  and add them to your config 
+
+
 from version 0.1-rc2
 ----------------------------------------
 * replace index.php
 * replace all files in folder /bin/
 * replace all files in folder /program/
 * replace all files in folder /skins/default/
+* run all commands in SQL/[yourdbtype].update.sql
 
 
 from version 0.1-rc1