Add a patch to avoid duplicate boundaries in headers when adding an

[roundcube.git] / UPGRADING

diff --git a/UPGRADING b/UPGRADING
index 9b5ac453264856071d04ddc19619088abf056119..6362e0ca54678ad90b434f5cfc7cf6d7fe334eaf 100644 (file)
--- a/UPGRADING
+++ b/UPGRADING
@@ -1,9 +1,64 @@
-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
@@ -11,6 +66,8 @@ from version 0.1-stable
 * 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
@@ -28,7 +85,6 @@ from version 0.1-rc1
 * 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
 * If you have LDAP servers configured you should re-configure
   the config entries using the template given in /config/main.inc.php.dist
 
@@ -39,7 +95,8 @@ from version 0.1-beta2
 * replace all files in folder /bin/
 * replace all files in folder /program/
 * replace all files in folder /skins/default/
-* re-initalize the database with [yourdbtype].initial.sql
+* run all commands in SQL/[yourdbtype].update.sql or
+  re-initalize the database with [yourdbtype].initial.sql
 * add these lines to /config/main.inc.php
    $rcmail_config['draft_autosave'] = 300;
    $rcmail_config['date_today'] = 'H:i';
@@ -53,7 +110,8 @@ form version 0.1-beta
 * replace all files in folder /bin/
 * replace all files in folder /program/
 * replace all files in folder /skins/default/
-* re-initalize the database with [yourdbtype].initial.sql
+* run all commands in SQL/[yourdbtype].update.sql or
+  re-initalize the database with [yourdbtype].initial.sql
 * add this line to /config/db.inc.php
    $rcmail_config['db_persistent'] = false;
 * add these lines to /config/main.inc.php